ngwr 11.1.0 → 12.0.0

package/fesm2022/{ngwr-date-adapter.mjs → ngwr-date.mjs}

@@ -41,12 +41,19 @@ class WrDateAdapter {
  * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
  */
 /**
- * BCP 47 locale tag used by {@link WrDateAdapter} implementations for
- * formatting, parsing, and locale-derived defaults (first day of week,
- * month / day names). Defaults to `navigator.language` in the browser and
- * `'en-US'` on the server.
+ * BCP 47 locale tag the {@link WrDateAdapter} implementations read. Defaults to
+ * `navigator.language` in the browser and `'en-US'` on the server; override via
+ * {@link provideWrDateAdapter}'s `locale` option.
  *
- * Override via {@link provideWrDateAdapter}'s `locale` option.
+ * **How far it reaches depends on the adapter, and the difference matters.**
+ * The luxon adapter threads it through everything — every `DateTime` is
+ * constructed with it, and `format` / `parse` call `setLocale`. The date-fns
+ * adapter reads it only for locale-DERIVED defaults (first day of week); its
+ * `format` and `parse` pass no locale to date-fns, so they stay on that
+ * library's module default. Setting this token and expecting French month names
+ * out of `WrDateFnsAdapter` gets English ones, and the parse side of that
+ * mismatch is silent rather than loud — see the adapter's own class docs for the
+ * lever (`setDefaultOptions`).
  */
 const WR_DATE_LOCALE = new InjectionToken('WR_DATE_LOCALE', {
     providedIn: 'root',
@@ -227,7 +234,7 @@ class WrNativeDateAdapter extends WrDateAdapter {
     // while still accepting any other string as a raw token pattern.
     format(date, formatKeyOrString) {
         if (isNamedFormat(formatKeyOrString)) {
-            return new Intl.DateTimeFormat(this.locale, INTL_OPTIONS[formatKeyOrString]).format(date);
+            return this.intl(formatKeyOrString).format(date);
         }
         return this.formatWithTokens(date, formatKeyOrString);
     }
@@ -259,6 +266,25 @@ class WrNativeDateAdapter extends WrDateAdapter {
         }
         return this.locale.toLowerCase().startsWith('en-us') ? 0 : 1;
     }
+    /**
+     * One `Intl.DateTimeFormat` per named format, built once.
+     *
+     * Constructing one is the expensive part of `format()`, and this adapter is
+     * called per CELL: `wr-event-calendar` builds an `aria-label` for every time
+     * slot on every day, so a week view asked for hundreds of identical
+     * formatters. `locale` is injected once and never changes for the life of the
+     * adapter, so the cache needs no invalidation — that is the whole reason it
+     * can be this simple.
+     */
+    formatters = new Map();
+    intl(key) {
+        let found = this.formatters.get(key);
+        if (!found) {
+            found = new Intl.DateTimeFormat(this.locale, INTL_OPTIONS[key]);
+            this.formatters.set(key, found);
+        }
+        return found;
+    }
     getDayOfWeekNames(style) {
         const formatter = new Intl.DateTimeFormat(this.locale, { weekday: style });
         const first = this.getFirstDayOfWeek();
@@ -424,10 +450,10 @@ class WrNativeDateAdapter extends WrDateAdapter {
             return null;
         return out;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: WrNativeDateAdapter, deps: [], target: i0.ɵɵFactoryTarget.Service });
-    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.1", ngImport: i0, type: WrNativeDateAdapter });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: WrNativeDateAdapter, deps: [], target: i0.ɵɵFactoryTarget.Service });
+    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.2", ngImport: i0, type: WrNativeDateAdapter });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: WrNativeDateAdapter, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: WrNativeDateAdapter, decorators: [{
             type: Service
         }] });
 
@@ -467,4 +493,4 @@ function provideWrDateAdapter(options = {}) {
  */
 
 export { WR_DATE_LOCALE, WrDateAdapter, WrNativeDateAdapter, isNamedFormat, provideWrDateAdapter };
-//# sourceMappingURL=ngwr-date-adapter.mjs.map
+//# sourceMappingURL=ngwr-date.mjs.map

package/fesm2022/ngwr-date.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngwr-date.mjs","sources":["../../../projects/lib/date/wr-date-adapter.ts","../../../projects/lib/date/tokens/wr-date-locale.token.ts","../../../projects/lib/date/wr-native-date-adapter.ts","../../../projects/lib/date/provide-wr-date-adapter.ts","../../../projects/lib/date/ngwr-date.ts"],"sourcesContent":["/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n */\n\nimport type { WrDateFormat } from './interfaces';\n\n/**\n * Abstraction over a date object so the calendar, date picker and time picker\n * can work with `Date`, `date-fns`, `luxon`, or any other library a consumer\n * prefers — without changing component code.\n *\n * Default implementation: {@link WrNativeDateAdapter} (native `Date`,\n * `Intl.DateTimeFormat`). Register a different adapter via\n * `provideWrDateAdapter({ adapter: MyAdapter })`.\n *\n * Used as both the type and the DI token — `inject(WrDateAdapter)` works\n * directly thanks to Angular's class-as-token resolution.\n *\n * Every \"mutating\" method (`addX`, `setTime`) returns a **new** value;\n * adapters never mutate in place so consumers can pass dates around safely.\n */\nexport abstract class WrDateAdapter<TDate = Date> {\n  // Construction & identity\n\n  /** Current moment. */\n  abstract today(): TDate;\n\n  /** Defensive clone — must return an independent value, never the same reference. */\n  abstract clone(date: TDate): TDate;\n\n  /** Build a date from year / month (0-based) / day. */\n  abstract createDate(year: number, month: number, day: number): TDate;\n\n  /** `false` for `NaN` / invalid input. */\n  abstract isValid(date: TDate): boolean;\n\n  // Accessors\n\n  abstract getYear(date: TDate): number;\n  /** `0` (January) – `11` (December). */\n  abstract getMonth(date: TDate): number;\n  /** Day of the month, `1`-`31`. */\n  abstract getDate(date: TDate): number;\n  /** `0` (Sunday) – `6` (Saturday). */\n  abstract getDayOfWeek(date: TDate): number;\n  abstract getDaysInMonth(date: TDate): number;\n  abstract getHours(date: TDate): number;\n  abstract getMinutes(date: TDate): number;\n  abstract getSeconds(date: TDate): number;\n\n  // Immutable math\n\n  abstract addYears(date: TDate, amount: number): TDate;\n  abstract addMonths(date: TDate, amount: number): TDate;\n  abstract addDays(date: TDate, amount: number): TDate;\n  /** Returns a new date with the time portion replaced. */\n  abstract setTime(date: TDate, hours: number, minutes: number, seconds: number): TDate;\n\n  // Comparison\n\n  abstract isSameDay(a: TDate, b: TDate): boolean;\n  abstract isSameMonth(a: TDate, b: TDate): boolean;\n  /** Negative if `a < b`, positive if `a > b`, zero if equal (compared at day precision). */\n  abstract compareDate(a: TDate, b: TDate): number;\n\n  /**\n   * Convenience used by the calendar's range UI. Inclusive on both ends.\n   * Implementation can stay on the base class because it delegates to\n   * `compareDate`.\n   */\n  isWithinRange(date: TDate, start: TDate, end: TDate): boolean {\n    return this.compareDate(date, start) >= 0 && this.compareDate(date, end) <= 0;\n  }\n\n  // Formatting / parsing\n\n  /**\n   * Format a date. Accepts either a named {@link WrDateFormat} key (which the\n   * adapter resolves locale-aware) or a raw format string (`'dd.MM.yyyy'`).\n   *\n   * Supported tokens for raw strings: `yyyy`, `yy`, `MMMM`, `MMM`, `MM`, `M`,\n   * `dd`, `d`, `HH`, `H`, `hh`, `h`, `mm`, `ss`, `a` (am / pm).\n   */\n  abstract format(date: TDate, formatKeyOrString: WrDateFormat | (string & {})): string;\n\n  /**\n   * Parse a string into a date. Returns `null` when parsing fails. Accepts\n   * the same `formatKeyOrString` set as {@link format}.\n   */\n  abstract parse(value: string, formatKeyOrString: WrDateFormat | (string & {})): TDate | null;\n\n  // Locale info\n\n  /** `0` Sunday, `1` Monday — locale-dependent. */\n  abstract getFirstDayOfWeek(): number;\n\n  /** Names ordered from `getFirstDayOfWeek()` onwards. Length 7. */\n  abstract getDayOfWeekNames(style: 'narrow' | 'short' | 'long'): readonly string[];\n\n  /** Names from January (index `0`) to December (`11`). Length 12. */\n  abstract getMonthNames(style: 'narrow' | 'short' | 'long'): readonly string[];\n}\n","/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n */\n\nimport { isPlatformBrowser } from '@angular/common';\nimport { InjectionToken, PLATFORM_ID, inject } from '@angular/core';\n\n/**\n * BCP 47 locale tag the {@link WrDateAdapter} implementations read. Defaults to\n * `navigator.language` in the browser and `'en-US'` on the server; override via\n * {@link provideWrDateAdapter}'s `locale` option.\n *\n * **How far it reaches depends on the adapter, and the difference matters.**\n * The luxon adapter threads it through everything — every `DateTime` is\n * constructed with it, and `format` / `parse` call `setLocale`. The date-fns\n * adapter reads it only for locale-DERIVED defaults (first day of week); its\n * `format` and `parse` pass no locale to date-fns, so they stay on that\n * library's module default. Setting this token and expecting French month names\n * out of `WrDateFnsAdapter` gets English ones, and the parse side of that\n * mismatch is silent rather than loud — see the adapter's own class docs for the\n * lever (`setDefaultOptions`).\n */\nexport const WR_DATE_LOCALE = new InjectionToken<string>('WR_DATE_LOCALE', {\n  providedIn: 'root',\n  factory: () => {\n    // Node 21+ also defines `navigator`, and reports the *build machine's*\n    // locale — so a `typeof` probe silently bakes that locale into\n    // prerendered output (wrong month names, wrong first day of week).\n    // Ask the platform instead.\n    if (isPlatformBrowser(inject(PLATFORM_ID)) && navigator.language) {\n      return navigator.language;\n    }\n    return 'en-US';\n  },\n});\n","/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n */\n\nimport { Service, inject } from '@angular/core';\n\nimport type { WrDateFormat } from './interfaces';\nimport { WR_DATE_LOCALE } from './tokens';\nimport { WrDateAdapter } from './wr-date-adapter';\n\nconst NAMED_KEYS = new Set<WrDateFormat>([\n  'shortDate',\n  'mediumDate',\n  'longDate',\n  'time',\n  'shortDateTime',\n  'mediumDateTime',\n]);\n\nconst INTL_OPTIONS: Readonly<Record<WrDateFormat, Intl.DateTimeFormatOptions>> = {\n  shortDate: { year: 'numeric', month: 'numeric', day: 'numeric' },\n  mediumDate: { year: 'numeric', month: 'short', day: 'numeric' },\n  longDate: { year: 'numeric', month: 'long', day: 'numeric' },\n  time: { hour: '2-digit', minute: '2-digit' },\n  shortDateTime: { year: 'numeric', month: 'numeric', day: 'numeric', hour: '2-digit', minute: '2-digit' },\n  mediumDateTime: { year: 'numeric', month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' },\n};\n\n/** Recognised tokens, longest first so `MMMM` matches before `MMM`. */\n/**\n * Every token, with single-quoted runs taken FIRST so they win.\n *\n * Without that, the one-letter tokens match letters inside literal text: `'yyyy [year]'`\n * came out as `2025 [yeamr]`, because the `a` in \"year\" was read as the meridiem token.\n * Quote literals the way `DatePipe` and LDML do — `'at'` — and `''` for a real quote.\n */\nconst PART_RE = /'([^']*)'|yyyy|yy|MMMM|MMM|MM|M|dd|d|HH|H|hh|h|mm|ss|a/g;\n\nfunction pad(n: number, width = 2): string {\n  return String(Math.abs(n)).padStart(width, '0');\n}\n\n/** Whether `value` is one of the shared named format keys. */\nfunction isNamedFormat(value: string): value is WrDateFormat {\n  return NAMED_KEYS.has(value as WrDateFormat);\n}\n\nfunction tokenToRegex(token: string): string {\n  switch (token) {\n    case 'yyyy':\n      return '(\\\\d{4})';\n    case 'yy':\n      return '(\\\\d{2})';\n    case 'MM':\n    case 'dd':\n    case 'HH':\n    case 'hh':\n    case 'mm':\n    case 'ss':\n      return '(\\\\d{2})';\n    case 'M':\n    case 'd':\n    case 'H':\n    case 'h':\n      return '(\\\\d{1,2})';\n    case 'a':\n      return '(am|pm|AM|PM)';\n    default:\n      return '(.+)';\n  }\n}\n\n/**\n * Reference {@link WrDateAdapter} implementation backed by the native `Date`\n * object and `Intl.DateTimeFormat`. Zero external dependencies. Suitable for\n * most apps — swap to a `date-fns` / `luxon` adapter only when you need\n * timezone-aware math or richer parsing.\n */\n@Service()\nexport class WrNativeDateAdapter extends WrDateAdapter<Date> {\n  private readonly locale = inject(WR_DATE_LOCALE);\n\n  // Construction & identity\n\n  today(): Date {\n    return new Date();\n  }\n\n  clone(date: Date): Date {\n    return new Date(date.getTime());\n  }\n\n  createDate(year: number, month: number, day: number): Date {\n    // Native Date constructor with year < 100 maps to 1900 + year unless we explicitly setFullYear.\n    const d = new Date(year, month, day);\n    if (year >= 0 && year < 100) d.setFullYear(year);\n    return d;\n  }\n\n  isValid(date: Date): boolean {\n    return date instanceof Date && !Number.isNaN(date.getTime());\n  }\n\n  // Accessors\n\n  getYear(date: Date): number {\n    return date.getFullYear();\n  }\n\n  getMonth(date: Date): number {\n    return date.getMonth();\n  }\n\n  getDate(date: Date): number {\n    return date.getDate();\n  }\n\n  getDayOfWeek(date: Date): number {\n    return date.getDay();\n  }\n\n  getDaysInMonth(date: Date): number {\n    return new Date(date.getFullYear(), date.getMonth() + 1, 0).getDate();\n  }\n\n  getHours(date: Date): number {\n    return date.getHours();\n  }\n\n  getMinutes(date: Date): number {\n    return date.getMinutes();\n  }\n\n  getSeconds(date: Date): number {\n    return date.getSeconds();\n  }\n\n  // Immutable math\n\n  addYears(date: Date, amount: number): Date {\n    const d = this.clone(date);\n    d.setFullYear(d.getFullYear() + amount);\n    return d;\n  }\n\n  addMonths(date: Date, amount: number): Date {\n    const d = this.clone(date);\n    const desiredDay = d.getDate();\n    d.setDate(1);\n    d.setMonth(d.getMonth() + amount);\n    // Clamp day to the new month's length (Jan 31 + 1 month → Feb 28/29).\n    d.setDate(Math.min(desiredDay, this.getDaysInMonth(d)));\n    return d;\n  }\n\n  addDays(date: Date, amount: number): Date {\n    // A calendar day, not 86 400 000 ms. Where daylight saving applies a day can be 23 or\n    // 25 hours long, so millisecond arithmetic drifts the wall clock and — across an\n    // autumn change — lands back on the same calendar date, which makes a month grid\n    // repeat a day and lose one. Not observable in a fixed-offset timezone, which is why\n    // the reason lives here rather than only in a test.\n    const d = this.clone(date);\n    d.setDate(d.getDate() + amount);\n    return d;\n  }\n\n  setTime(date: Date, hours: number, minutes: number, seconds: number): Date {\n    const d = this.clone(date);\n    d.setHours(hours, minutes, seconds, 0);\n    return d;\n  }\n\n  // Comparison\n\n  isSameDay(a: Date, b: Date): boolean {\n    return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();\n  }\n\n  isSameMonth(a: Date, b: Date): boolean {\n    return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth();\n  }\n\n  compareDate(a: Date, b: Date): number {\n    const ay = a.getFullYear();\n    const by = b.getFullYear();\n    if (ay !== by) return ay - by;\n    const am = a.getMonth();\n    const bm = b.getMonth();\n    if (am !== bm) return am - bm;\n    return a.getDate() - b.getDate();\n  }\n\n  // Formatting / parsing\n\n  // `(string & {})` keeps autocomplete for the WrDateFormat literals\n  // while still accepting any other string as a raw token pattern.\n  format(date: Date, formatKeyOrString: WrDateFormat | (string & {})): string {\n    if (isNamedFormat(formatKeyOrString)) {\n      return this.intl(formatKeyOrString).format(date);\n    }\n    return this.formatWithTokens(date, formatKeyOrString);\n  }\n\n  parse(value: string, formatKeyOrString: WrDateFormat | (string & {})): Date | null {\n    const raw = value?.trim();\n    if (!raw) return null;\n\n    // Named formats fall back to `new Date()` parsing — best-effort, locale-fragile.\n    if (isNamedFormat(formatKeyOrString)) {\n      const d = new Date(raw);\n      return this.isValid(d) ? d : null;\n    }\n\n    return this.parseWithTokens(raw, formatKeyOrString);\n  }\n\n  // Locale info\n\n  getFirstDayOfWeek(): number {\n    // `Intl.Locale.prototype.getWeekInfo` is Stage 3 — not in TS lib types yet,\n    // so we probe at runtime through an unknown cast.\n    try {\n      const locale = new Intl.Locale(this.locale) as unknown as { getWeekInfo?: () => { firstDay: number } };\n      const info = locale.getWeekInfo?.();\n      if (info && typeof info.firstDay === 'number') {\n        // Intl uses 1 (Mon) – 7 (Sun); we use 0 (Sun) – 6 (Sat).\n        return info.firstDay % 7;\n      }\n    } catch {\n      // Browser doesn't support Intl.Locale or getWeekInfo — fall through.\n    }\n    return this.locale.toLowerCase().startsWith('en-us') ? 0 : 1;\n  }\n\n  /**\n   * One `Intl.DateTimeFormat` per named format, built once.\n   *\n   * Constructing one is the expensive part of `format()`, and this adapter is\n   * called per CELL: `wr-event-calendar` builds an `aria-label` for every time\n   * slot on every day, so a week view asked for hundreds of identical\n   * formatters. `locale` is injected once and never changes for the life of the\n   * adapter, so the cache needs no invalidation — that is the whole reason it\n   * can be this simple.\n   */\n  private readonly formatters = new Map<string, Intl.DateTimeFormat>();\n\n  private intl(key: WrDateFormat): Intl.DateTimeFormat {\n    let found = this.formatters.get(key);\n    if (!found) {\n      found = new Intl.DateTimeFormat(this.locale, INTL_OPTIONS[key]);\n      this.formatters.set(key, found);\n    }\n    return found;\n  }\n\n  getDayOfWeekNames(style: 'narrow' | 'short' | 'long'): readonly string[] {\n    const formatter = new Intl.DateTimeFormat(this.locale, { weekday: style });\n    const first = this.getFirstDayOfWeek();\n    // Pick a reference Sunday and walk seven days.\n    const base = new Date(2024, 0, 7); // Sunday 7 Jan 2024\n    const out: string[] = [];\n    for (let i = 0; i < 7; i++) {\n      const d = new Date(base);\n      d.setDate(base.getDate() + ((first + i) % 7));\n      out.push(formatter.format(d));\n    }\n    return out;\n  }\n\n  getMonthNames(style: 'narrow' | 'short' | 'long'): readonly string[] {\n    const formatter = new Intl.DateTimeFormat(this.locale, { month: style });\n    const out: string[] = [];\n    for (let i = 0; i < 12; i++) {\n      out.push(formatter.format(new Date(2024, i, 15)));\n    }\n    return out;\n  }\n\n  // Internals: token-based format / parse\n\n  private formatWithTokens(date: Date, pattern: string): string {\n    const year = date.getFullYear();\n    const month = date.getMonth();\n    const day = date.getDate();\n    const hours24 = date.getHours();\n    const hours12 = hours24 % 12 === 0 ? 12 : hours24 % 12;\n    const minutes = date.getMinutes();\n    const seconds = date.getSeconds();\n    const monthNames = this.getMonthNames('long');\n    const monthShort = this.getMonthNames('short');\n\n    return pattern.replace(PART_RE, (part, quoted?: string) => {\n      // A quoted run is emitted as-is; `''` is how a single quote is written.\n      if (quoted !== undefined) return quoted === '' ? \"'\" : quoted;\n      const token = part;\n      switch (token) {\n        case 'yyyy':\n          return pad(year, 4);\n        case 'yy':\n          return pad(year % 100, 2);\n        case 'MMMM':\n          return monthNames[month] ?? '';\n        case 'MMM':\n          return monthShort[month] ?? '';\n        case 'MM':\n          return pad(month + 1);\n        case 'M':\n          return String(month + 1);\n        case 'dd':\n          return pad(day);\n        case 'd':\n          return String(day);\n        case 'HH':\n          return pad(hours24);\n        case 'H':\n          return String(hours24);\n        case 'hh':\n          return pad(hours12);\n        case 'h':\n          return String(hours12);\n        case 'mm':\n          return pad(minutes);\n        case 'ss':\n          return pad(seconds);\n        case 'a':\n          return hours24 < 12 ? 'am' : 'pm';\n      }\n      return token;\n    });\n  }\n\n  private parseWithTokens(value: string, pattern: string): Date | null {\n    const tokens: string[] = [];\n    const monthLong = this.getMonthNames('long');\n    const monthShort = this.getMonthNames('short');\n    const escaped = pattern.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n    const regex = escaped.replace(PART_RE, (part, quoted?: string) => {\n      if (quoted !== undefined) {\n        // Literal text matches itself and captures nothing, so the token indices stay\n        // aligned with the groups below.\n        return quoted === '' ? \"'\" : quoted;\n      }\n      tokens.push(part);\n      return tokenToRegex(part);\n    });\n\n    const match = new RegExp(`^${regex}$`).exec(value);\n    if (!match) return null;\n\n    let year = new Date().getFullYear();\n    let month = 0;\n    let day = 1;\n    let hours = 0;\n    let minutes = 0;\n    let seconds = 0;\n    let isPm = false;\n    let hadHour12 = false;\n    let hour12 = 0;\n\n    for (let i = 0; i < tokens.length; i++) {\n      const token = tokens[i];\n      const raw = match[i + 1];\n      const n = Number(raw);\n      switch (token) {\n        case 'yyyy':\n          year = n;\n          break;\n        case 'yy':\n          year = 2000 + n;\n          break;\n        case 'MM':\n        case 'M':\n          month = n - 1;\n          break;\n        case 'MMM':\n        case 'MMMM': {\n          const names = token === 'MMM' ? monthShort : monthLong;\n          const found = names.findIndex(name => name.toLowerCase() === raw.toLowerCase());\n          if (found < 0) return null;\n          month = found;\n          break;\n        }\n        case 'dd':\n        case 'd':\n          day = n;\n          break;\n        case 'HH':\n        case 'H':\n          hours = n;\n          break;\n        case 'hh':\n        case 'h':\n          hadHour12 = true;\n          hour12 = n;\n          break;\n        case 'mm':\n          minutes = n;\n          break;\n        case 'ss':\n          seconds = n;\n          break;\n        case 'a':\n          isPm = raw.toLowerCase() === 'pm';\n          break;\n      }\n    }\n\n    if (hadHour12) {\n      hours = (hour12 % 12) + (isPm ? 12 : 0);\n    }\n\n    // `new Date(2025, 12, 45)` does not fail — it rolls forward into the next year — and\n    // `isValid` is happy with the result, so a text field turned nonsense into a confident\n    // wrong answer. The clock parts are range-checked directly; the month and the day are\n    // checked by comparing what came back, which catches every rollover including a month\n    // of 12 or -1.\n    if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59 || seconds < 0 || seconds > 59) return null;\n\n    const out = new Date(year, month, day, hours, minutes, seconds);\n    if (!this.isValid(out)) return null;\n    // The day is range-checked by construction: anything the calendar rolled over comes\n    // back as a different month or a different day.\n    if (out.getMonth() !== month || out.getDate() !== day) return null;\n    return out;\n  }\n}\n\nexport { isNamedFormat };\n","/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n */\n\nimport { type EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\n\nimport type { WrDateAdapterOptions } from './interfaces';\nimport { WR_DATE_LOCALE } from './tokens';\nimport { WrDateAdapter } from './wr-date-adapter';\nimport { WrNativeDateAdapter } from './wr-native-date-adapter';\n\n/**\n * Register the date adapter and locale used by the calendar / date picker /\n * time picker. Call once at bootstrap.\n *\n * @example\n * ```ts\n * bootstrapApplication(AppComponent, {\n *   providers: [\n *     provideWrDateAdapter(),                 // native, browser locale\n *     // provideWrDateAdapter({ locale: 'ru-RU' }),\n *     // provideWrDateAdapter({ adapter: MyDateFnsAdapter, locale: 'fr' }),\n *   ],\n * });\n * ```\n */\nexport function provideWrDateAdapter(options: WrDateAdapterOptions = {}): EnvironmentProviders {\n  const providers: Parameters<typeof makeEnvironmentProviders>[0] = [\n    { provide: WrDateAdapter, useClass: options.adapter ?? WrNativeDateAdapter },\n  ];\n\n  if (options.locale) {\n    providers.push({ provide: WR_DATE_LOCALE, useValue: options.locale });\n  }\n\n  return makeEnvironmentProviders(providers);\n}\n\nexport type { WrDateAdapterOptions } from './interfaces';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/ngwr-decrypt-text-testing.mjs

@@ -0,0 +1,261 @@
+import { ComponentHarness, HarnessPredicate } from '@angular/cdk/testing';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/** The readable copy of the string, carried once and hidden with CSS. */
+const SR_ONLY = '.wr-decrypt-text__sr-only';
+/** One span per CODE POINT of whatever is on screen this frame. */
+const CHAR = '.wr-decrypt-text__char';
+/** The modifier that carries the entire progress model. */
+const ENCRYPTED = '.wr-decrypt-text__char--encrypted';
+/**
+ * The wrapper holding every scramble character.
+ *
+ * Addressed structurally because it is the one element in this template with no BEM
+ * class of its own — see {@link WrDecryptTextHarness.isAnimatedLayerHidden}, which
+ * exists precisely because a selector this fragile should be written down once rather
+ * than assumed in every spec.
+ */
+const SCRAMBLE = `${SR_ONLY} + span`;
+/** Exactly what the element holds — untrimmed, unlike `TestElement.text()`. */
+async function rawText(element) {
+    return (await element.getProperty('textContent')) ?? '';
+}
+/**
+ * Test harness for `<wr-decrypt-text>`.
+ *
+ * **Two layers, two questions, and they are meant to disagree.** The component renders
+ * the real string once in a visually-hidden span and the scramble in a parallel
+ * `aria-hidden` layer, so {@link getAccessibleText} is what a screen reader hears and
+ * {@link getRenderedText} is what a sighted reader sees. Mid-reveal the second is
+ * literal gibberish while the first must be untouched — that is the contract, and it is
+ * the half nobody looks at. A spec asserting only the visible glyphs would pass on a
+ * component that announced `XQ#PZ`.
+ *
+ * **Prefer the class over the glyphs.** {@link getRevealedIndices},
+ * {@link getEncryptedCount} and {@link isFullyRevealed} read
+ * `.wr-decrypt-text__char--encrypted`, which is deterministic with no stubbing at all —
+ * they are what tell `revealDirection` `'start'` from `'end'` from `'center'`, one index
+ * per tick. {@link getRenderedText} reads the glyphs themselves, which are a fresh
+ * `Math.random()` draw per tick, so stub it (`vi.spyOn(Math, 'random')
+ * .mockReturnValue(0)`) before asserting a string.
+ *
+ * **The clock is the spec's, not the harness's.** The reveal is a `setInterval` this
+ * class does not own, so there is no `advance(ms)` and no `waitUntilRevealed()`: one
+ * would flake on a loaded machine and the other would silently require fake timers to
+ * have been installed. Fake `setInterval` / `clearInterval` and nothing else — faking
+ * the microtask queue freezes the stabilization every `await harness.*()` runs through —
+ * then advance the clock yourself between reads.
+ *
+ * **There is no keyboard path, and this harness does not pretend there is one.**
+ * {@link hover}, {@link mouseAway} and {@link click} are the component's only triggers;
+ * with `animateOn="click"` the host takes a click handler while carrying no role, no
+ * `tabindex` and no keydown handler, so a `focus()` / `sendKeys(Enter)` affordance here
+ * would make a spec pass while a keyboard or switch user could not reveal the text at
+ * all. There is no `enterViewport()` either: `'view'` and `'inViewHover'` hang off an
+ * `IntersectionObserver` jsdom does not implement, so the spec stubs the global and
+ * fires it.
+ *
+ * **Also deliberately absent:** `isAnimating()` — the component has such a signal and it
+ * never reaches the DOM, and deriving it from "something is encrypted" would be wrong in
+ * exactly the interesting case, since `animateOn="click"` rests fully encrypted and
+ * perfectly still. `getSpeed()` / `getMaxIterations()` / `getRevealDirection()` /
+ * `getClickMode()` / `getAnimateOn()` — inputs that are never reflected anywhere, so
+ * reporting them would mean reading the component instance rather than the rendered
+ * control; they are observable as behaviour, which is what the methods above measure.
+ * `getScrambleAlphabet()` — the pool is internal and each frame shows one random draw
+ * from it, so any reconstruction is a guess that gets worse the shorter the string.
+ * `getCharColors()` / `isDimmed()` — the `--encrypted` rule is deliberately EMPTY, a
+ * styling hook for consumers, so there is nothing painted to read in any environment.
+ *
+ * @example
+ * ```ts
+ * const secret = await loader.getHarness(WrDecryptTextHarness.with({ text: 'Hello' }));
+ *
+ * await secret.hover();
+ * vi.advanceTimersByTime(50);
+ *
+ * expect(await secret.getRevealedIndices()).toEqual([0]);   // sequential, from the start
+ * expect(await secret.getAccessibleText()).toBe('Hello');   // untouched throughout
+ * ```
+ *
+ * @see https://ngwr.dev/guides/testing
+ */
+class WrDecryptTextHarness extends ComponentHarness {
+    static hostSelector = 'wr-decrypt-text';
+    /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */
+    static with(options = {}) {
+        return new HarnessPredicate(WrDecryptTextHarness, options)
+            .addOption('text', options.text, (harness, text) => HarnessPredicate.stringMatches(harness.getAccessibleText(), text))
+            .addOption('revealed', options.revealed, async (harness, revealed) => {
+            // Not `isFullyRevealed()`, which refuses to answer for an instance that rendered
+            // no characters. A predicate is the wrong place to throw — a single empty
+            // instance would take down every query on the page — so the vacuous case is
+            // spelled out here instead, and matches neither `true` nor `false`.
+            if ((await harness.getCharCount()) === 0)
+                return false;
+            return ((await harness.getEncryptedCount()) === 0) === revealed;
+        });
+    }
+    chars = this.locatorForAll(CHAR);
+    encrypted = this.locatorForAll(ENCRYPTED);
+    /**
+     * The real string, as the one readable copy holds it.
+     *
+     * The single highest-value assertion here: it must stay equal to the `text` input on
+     * every frame, while the visible layer is unreadable by design. Lose this span and the
+     * component announces nothing at all — every drawn character sits under `aria-hidden`,
+     * so no other part of the DOM would change.
+     *
+     * Untrimmed, so that it can be compared against {@link getRenderedText} without one
+     * side of the comparison quietly forgiving a lost leading space.
+     */
+    async getAccessibleText() {
+        return rawText(await this.locatorFor(SR_ONLY)());
+    }
+    /**
+     * What is on screen this frame — scramble glyphs and all, in document order.
+     *
+     * Plain before anything triggers it, gibberish mid-reveal, and the real string once it
+     * settles; comparing it against {@link getAccessibleText} is how a spec says which of
+     * those it is looking at. `useOriginalCharsOnly` is visible only here — every glyph
+     * has to be one the text really contains.
+     *
+     * Nondeterministic unless the spec stubs `Math.random`, because each unrevealed
+     * position is an independent draw from the pool. When the assertion does not actually
+     * need the glyphs, {@link getRevealedIndices} answers the same progress question off
+     * the class and needs no stub.
+     */
+    async getRenderedText() {
+        return (await Promise.all((await this.chars()).map(rawText))).join('');
+    }
+    /**
+     * How many characters the animation walks.
+     *
+     * CODE POINTS, not UTF-16 units: `'a🚀b'` is 3 here, and the indices
+     * {@link getRevealedIndices} returns line up with `[...text]` rather than with plain
+     * `text[i]`. That distinction is not pedantry — counting units gave a sequential
+     * reveal extra ticks with no character to spend them on, and made "everything is
+     * revealed" disagree with what was on screen.
+     */
+    async getCharCount() {
+        return (await this.chars()).length;
+    }
+    /**
+     * The positions that have settled on their real character, ascending.
+     *
+     * The payload method, and the deterministic one: it reads the `--encrypted` modifier
+     * rather than the glyphs, so no `Math.random` stub is involved. It is the only thing
+     * that separates `revealDirection` `'start'` (`[0]`, `[0, 1]`, …) from `'end'`
+     * (`[4]`, `[3, 4]`, …) from `'center'` (`[2]`, `[1, 2]`, …), and one index per tick is
+     * what makes a sequential reveal sequential.
+     *
+     * Ascending by position, NOT in the order the reveal visited them — the DOM records
+     * which characters have landed, never the path taken to them. Assert the set after
+     * each tick to pin an order.
+     */
+    async getRevealedIndices() {
+        const chars = await this.chars();
+        const states = await Promise.all(chars.map(char => char.hasClass('wr-decrypt-text__char--encrypted')));
+        return states.flatMap((isEncrypted, index) => (isEncrypted ? [] : [index]));
+    }
+    /**
+     * How many characters are still scrambled.
+     *
+     * The coarse progress read, and the cheapest way to say "scrambled on hover", "plain on
+     * leave", or "a reader who asked for less motion never saw a scramble at all". Class-
+     * based like {@link getRevealedIndices}, so it too is random-proof.
+     */
+    async getEncryptedCount() {
+        return (await this.encrypted()).length;
+    }
+    /**
+     * Whether every character has settled.
+     *
+     * Deliberately does NOT also compare {@link getRenderedText} against
+     * {@link getAccessibleText}: folding two conditions into one boolean hides which of
+     * them broke, and a spec that wants both should write both lines.
+     *
+     * Throws when nothing was rendered. "No character is encrypted" is true of no
+     * characters, which is the same answer a component that stopped rendering its text
+     * would give — and this is the method most likely to be the only assertion in a test.
+     */
+    async isFullyRevealed() {
+        const total = await this.getCharCount();
+        if (total === 0) {
+            throw new Error('WrDecryptTextHarness.isFullyRevealed(): this <wr-decrypt-text> rendered no characters, so "nothing is ' +
+                'encrypted" is vacuously true — the same answer a component that stopped rendering its text would ' +
+                'give. Check `text` is set, or ask getCharCount().');
+        }
+        return (await this.getEncryptedCount()) === 0;
+    }
+    /**
+     * Whether the scramble layer is out of the accessibility tree.
+     *
+     * The contract that keeps a screen reader from spelling out `XQ#PZ` beside the real
+     * string it already read. Worth a method rather than an assumption because the wrapper
+     * holding the characters carries NO class — it can only be addressed as the readable
+     * span's next sibling, which any template reshuffle breaks.
+     *
+     * Throws when that structural selector finds nothing, rather than returning `false`: a
+     * missing wrapper and an unhidden one are different failures, and the answer to
+     * "is the scramble hidden" when there is no scramble layer at all is not `false`.
+     */
+    async isAnimatedLayerHidden() {
+        const scramble = await this.locatorForOptional(SCRAMBLE)();
+        if (!scramble) {
+            throw new Error('WrDecryptTextHarness.isAnimatedLayerHidden(): no scramble layer found. It carries no class of its own, ' +
+                `so it is addressed structurally as \`${SCRAMBLE}\` — a template that moved either span out from ` +
+                'under that selector breaks this read, and "false" would report the layer as ANNOUNCED rather than as ' +
+                'missing.');
+        }
+        return (await scramble.getAttribute('aria-hidden')) === 'true';
+    }
+    /**
+     * Point at it — the trigger for `animateOn` `'hover'` and `'inViewHover'`.
+     *
+     * Drives the component the way a user does, and works in a test because the trigger is
+     * an event rather than a gesture: `TestElement.hover()` dispatches `pointerenter`,
+     * `mouseover` and `mouseenter`, and the component listens for the last of those. A
+     * hand-rolled pointer-only dispatch would not reach it.
+     *
+     * Does nothing in the other two modes, exactly as a real pointer does nothing there.
+     */
+    async hover() {
+        return (await this.host()).hover();
+    }
+    /**
+     * Move the pointer off — the other half of hover mode.
+     *
+     * Pins the promise that leaving mid-scramble restores the real text IMMEDIATELY rather
+     * than letting the reveal play out: the reader took the effect away, so the string has
+     * to come back at once.
+     */
+    async mouseAway() {
+        return (await this.host()).mouseAway();
+    }
+    /**
+     * Click the host — the `animateOn="click"` trigger, and the only way to tell
+     * `clickMode` `'once'` from `'toggle'`.
+     *
+     * There is no keyboard equivalent, and that is a statement about the component rather
+     * than about this harness: in click mode the host carries a click handler with no role,
+     * no `tabindex` and no keydown handler, so a keyboard or switch user cannot reveal the
+     * text at all. A `sendKeys(Enter)` here would invent an affordance that does not exist
+     * and let a spec pass over the top of it.
+     */
+    async click() {
+        return (await this.host()).click();
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { WrDecryptTextHarness };
+//# sourceMappingURL=ngwr-decrypt-text-testing.mjs.map

package/fesm2022/ngwr-decrypt-text-testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngwr-decrypt-text-testing.mjs","sources":["../../../projects/lib/decrypt-text/testing/wr-decrypt-text-harness.ts","../../../projects/lib/decrypt-text/testing/ngwr-decrypt-text-testing.ts"],"sourcesContent":["/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n */\n\nimport { ComponentHarness, HarnessPredicate, type TestElement } from '@angular/cdk/testing';\n\nimport type { WrDecryptTextHarnessFilters } from './interfaces';\n\n/** The readable copy of the string, carried once and hidden with CSS. */\nconst SR_ONLY = '.wr-decrypt-text__sr-only';\n\n/** One span per CODE POINT of whatever is on screen this frame. */\nconst CHAR = '.wr-decrypt-text__char';\n\n/** The modifier that carries the entire progress model. */\nconst ENCRYPTED = '.wr-decrypt-text__char--encrypted';\n\n/**\n * The wrapper holding every scramble character.\n *\n * Addressed structurally because it is the one element in this template with no BEM\n * class of its own — see {@link WrDecryptTextHarness.isAnimatedLayerHidden}, which\n * exists precisely because a selector this fragile should be written down once rather\n * than assumed in every spec.\n */\nconst SCRAMBLE = `${SR_ONLY} + span`;\n\n/** Exactly what the element holds — untrimmed, unlike `TestElement.text()`. */\nasync function rawText(element: TestElement): Promise<string> {\n  return (await element.getProperty<string | null>('textContent')) ?? '';\n}\n\n/**\n * Test harness for `<wr-decrypt-text>`.\n *\n * **Two layers, two questions, and they are meant to disagree.** The component renders\n * the real string once in a visually-hidden span and the scramble in a parallel\n * `aria-hidden` layer, so {@link getAccessibleText} is what a screen reader hears and\n * {@link getRenderedText} is what a sighted reader sees. Mid-reveal the second is\n * literal gibberish while the first must be untouched — that is the contract, and it is\n * the half nobody looks at. A spec asserting only the visible glyphs would pass on a\n * component that announced `XQ#PZ`.\n *\n * **Prefer the class over the glyphs.** {@link getRevealedIndices},\n * {@link getEncryptedCount} and {@link isFullyRevealed} read\n * `.wr-decrypt-text__char--encrypted`, which is deterministic with no stubbing at all —\n * they are what tell `revealDirection` `'start'` from `'end'` from `'center'`, one index\n * per tick. {@link getRenderedText} reads the glyphs themselves, which are a fresh\n * `Math.random()` draw per tick, so stub it (`vi.spyOn(Math, 'random')\n * .mockReturnValue(0)`) before asserting a string.\n *\n * **The clock is the spec's, not the harness's.** The reveal is a `setInterval` this\n * class does not own, so there is no `advance(ms)` and no `waitUntilRevealed()`: one\n * would flake on a loaded machine and the other would silently require fake timers to\n * have been installed. Fake `setInterval` / `clearInterval` and nothing else — faking\n * the microtask queue freezes the stabilization every `await harness.*()` runs through —\n * then advance the clock yourself between reads.\n *\n * **There is no keyboard path, and this harness does not pretend there is one.**\n * {@link hover}, {@link mouseAway} and {@link click} are the component's only triggers;\n * with `animateOn=\"click\"` the host takes a click handler while carrying no role, no\n * `tabindex` and no keydown handler, so a `focus()` / `sendKeys(Enter)` affordance here\n * would make a spec pass while a keyboard or switch user could not reveal the text at\n * all. There is no `enterViewport()` either: `'view'` and `'inViewHover'` hang off an\n * `IntersectionObserver` jsdom does not implement, so the spec stubs the global and\n * fires it.\n *\n * **Also deliberately absent:** `isAnimating()` — the component has such a signal and it\n * never reaches the DOM, and deriving it from \"something is encrypted\" would be wrong in\n * exactly the interesting case, since `animateOn=\"click\"` rests fully encrypted and\n * perfectly still. `getSpeed()` / `getMaxIterations()` / `getRevealDirection()` /\n * `getClickMode()` / `getAnimateOn()` — inputs that are never reflected anywhere, so\n * reporting them would mean reading the component instance rather than the rendered\n * control; they are observable as behaviour, which is what the methods above measure.\n * `getScrambleAlphabet()` — the pool is internal and each frame shows one random draw\n * from it, so any reconstruction is a guess that gets worse the shorter the string.\n * `getCharColors()` / `isDimmed()` — the `--encrypted` rule is deliberately EMPTY, a\n * styling hook for consumers, so there is nothing painted to read in any environment.\n *\n * @example\n * ```ts\n * const secret = await loader.getHarness(WrDecryptTextHarness.with({ text: 'Hello' }));\n *\n * await secret.hover();\n * vi.advanceTimersByTime(50);\n *\n * expect(await secret.getRevealedIndices()).toEqual([0]);   // sequential, from the start\n * expect(await secret.getAccessibleText()).toBe('Hello');   // untouched throughout\n * ```\n *\n * @see https://ngwr.dev/guides/testing\n */\nexport class WrDecryptTextHarness extends ComponentHarness {\n  static hostSelector = 'wr-decrypt-text';\n\n  /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */\n  static with(options: WrDecryptTextHarnessFilters = {}): HarnessPredicate<WrDecryptTextHarness> {\n    return new HarnessPredicate(WrDecryptTextHarness, options)\n      .addOption('text', options.text, (harness, text) =>\n        HarnessPredicate.stringMatches(harness.getAccessibleText(), text)\n      )\n      .addOption('revealed', options.revealed, async (harness, revealed) => {\n        // Not `isFullyRevealed()`, which refuses to answer for an instance that rendered\n        // no characters. A predicate is the wrong place to throw — a single empty\n        // instance would take down every query on the page — so the vacuous case is\n        // spelled out here instead, and matches neither `true` nor `false`.\n        if ((await harness.getCharCount()) === 0) return false;\n        return ((await harness.getEncryptedCount()) === 0) === revealed;\n      });\n  }\n\n  private readonly chars = this.locatorForAll(CHAR);\n  private readonly encrypted = this.locatorForAll(ENCRYPTED);\n\n  /**\n   * The real string, as the one readable copy holds it.\n   *\n   * The single highest-value assertion here: it must stay equal to the `text` input on\n   * every frame, while the visible layer is unreadable by design. Lose this span and the\n   * component announces nothing at all — every drawn character sits under `aria-hidden`,\n   * so no other part of the DOM would change.\n   *\n   * Untrimmed, so that it can be compared against {@link getRenderedText} without one\n   * side of the comparison quietly forgiving a lost leading space.\n   */\n  async getAccessibleText(): Promise<string> {\n    return rawText(await this.locatorFor(SR_ONLY)());\n  }\n\n  /**\n   * What is on screen this frame — scramble glyphs and all, in document order.\n   *\n   * Plain before anything triggers it, gibberish mid-reveal, and the real string once it\n   * settles; comparing it against {@link getAccessibleText} is how a spec says which of\n   * those it is looking at. `useOriginalCharsOnly` is visible only here — every glyph\n   * has to be one the text really contains.\n   *\n   * Nondeterministic unless the spec stubs `Math.random`, because each unrevealed\n   * position is an independent draw from the pool. When the assertion does not actually\n   * need the glyphs, {@link getRevealedIndices} answers the same progress question off\n   * the class and needs no stub.\n   */\n  async getRenderedText(): Promise<string> {\n    return (await Promise.all((await this.chars()).map(rawText))).join('');\n  }\n\n  /**\n   * How many characters the animation walks.\n   *\n   * CODE POINTS, not UTF-16 units: `'a🚀b'` is 3 here, and the indices\n   * {@link getRevealedIndices} returns line up with `[...text]` rather than with plain\n   * `text[i]`. That distinction is not pedantry — counting units gave a sequential\n   * reveal extra ticks with no character to spend them on, and made \"everything is\n   * revealed\" disagree with what was on screen.\n   */\n  async getCharCount(): Promise<number> {\n    return (await this.chars()).length;\n  }\n\n  /**\n   * The positions that have settled on their real character, ascending.\n   *\n   * The payload method, and the deterministic one: it reads the `--encrypted` modifier\n   * rather than the glyphs, so no `Math.random` stub is involved. It is the only thing\n   * that separates `revealDirection` `'start'` (`[0]`, `[0, 1]`, …) from `'end'`\n   * (`[4]`, `[3, 4]`, …) from `'center'` (`[2]`, `[1, 2]`, …), and one index per tick is\n   * what makes a sequential reveal sequential.\n   *\n   * Ascending by position, NOT in the order the reveal visited them — the DOM records\n   * which characters have landed, never the path taken to them. Assert the set after\n   * each tick to pin an order.\n   */\n  async getRevealedIndices(): Promise<number[]> {\n    const chars = await this.chars();\n    const states = await Promise.all(chars.map(char => char.hasClass('wr-decrypt-text__char--encrypted')));\n    return states.flatMap((isEncrypted, index) => (isEncrypted ? [] : [index]));\n  }\n\n  /**\n   * How many characters are still scrambled.\n   *\n   * The coarse progress read, and the cheapest way to say \"scrambled on hover\", \"plain on\n   * leave\", or \"a reader who asked for less motion never saw a scramble at all\". Class-\n   * based like {@link getRevealedIndices}, so it too is random-proof.\n   */\n  async getEncryptedCount(): Promise<number> {\n    return (await this.encrypted()).length;\n  }\n\n  /**\n   * Whether every character has settled.\n   *\n   * Deliberately does NOT also compare {@link getRenderedText} against\n   * {@link getAccessibleText}: folding two conditions into one boolean hides which of\n   * them broke, and a spec that wants both should write both lines.\n   *\n   * Throws when nothing was rendered. \"No character is encrypted\" is true of no\n   * characters, which is the same answer a component that stopped rendering its text\n   * would give — and this is the method most likely to be the only assertion in a test.\n   */\n  async isFullyRevealed(): Promise<boolean> {\n    const total = await this.getCharCount();\n\n    if (total === 0) {\n      throw new Error(\n        'WrDecryptTextHarness.isFullyRevealed(): this <wr-decrypt-text> rendered no characters, so \"nothing is ' +\n          'encrypted\" is vacuously true — the same answer a component that stopped rendering its text would ' +\n          'give. Check `text` is set, or ask getCharCount().'\n      );\n    }\n\n    return (await this.getEncryptedCount()) === 0;\n  }\n\n  /**\n   * Whether the scramble layer is out of the accessibility tree.\n   *\n   * The contract that keeps a screen reader from spelling out `XQ#PZ` beside the real\n   * string it already read. Worth a method rather than an assumption because the wrapper\n   * holding the characters carries NO class — it can only be addressed as the readable\n   * span's next sibling, which any template reshuffle breaks.\n   *\n   * Throws when that structural selector finds nothing, rather than returning `false`: a\n   * missing wrapper and an unhidden one are different failures, and the answer to\n   * \"is the scramble hidden\" when there is no scramble layer at all is not `false`.\n   */\n  async isAnimatedLayerHidden(): Promise<boolean> {\n    const scramble = await this.locatorForOptional(SCRAMBLE)();\n\n    if (!scramble) {\n      throw new Error(\n        'WrDecryptTextHarness.isAnimatedLayerHidden(): no scramble layer found. It carries no class of its own, ' +\n          `so it is addressed structurally as \\`${SCRAMBLE}\\` — a template that moved either span out from ` +\n          'under that selector breaks this read, and \"false\" would report the layer as ANNOUNCED rather than as ' +\n          'missing.'\n      );\n    }\n\n    return (await scramble.getAttribute('aria-hidden')) === 'true';\n  }\n\n  /**\n   * Point at it — the trigger for `animateOn` `'hover'` and `'inViewHover'`.\n   *\n   * Drives the component the way a user does, and works in a test because the trigger is\n   * an event rather than a gesture: `TestElement.hover()` dispatches `pointerenter`,\n   * `mouseover` and `mouseenter`, and the component listens for the last of those. A\n   * hand-rolled pointer-only dispatch would not reach it.\n   *\n   * Does nothing in the other two modes, exactly as a real pointer does nothing there.\n   */\n  async hover(): Promise<void> {\n    return (await this.host()).hover();\n  }\n\n  /**\n   * Move the pointer off — the other half of hover mode.\n   *\n   * Pins the promise that leaving mid-scramble restores the real text IMMEDIATELY rather\n   * than letting the reveal play out: the reader took the effect away, so the string has\n   * to come back at once.\n   */\n  async mouseAway(): Promise<void> {\n    return (await this.host()).mouseAway();\n  }\n\n  /**\n   * Click the host — the `animateOn=\"click\"` trigger, and the only way to tell\n   * `clickMode` `'once'` from `'toggle'`.\n   *\n   * There is no keyboard equivalent, and that is a statement about the component rather\n   * than about this harness: in click mode the host carries a click handler with no role,\n   * no `tabindex` and no keydown handler, so a keyboard or switch user cannot reveal the\n   * text at all. A `sendKeys(Enter)` here would invent an affordance that does not exist\n   * and let a spec pass over the top of it.\n   */\n  async click(): Promise<void> {\n    return (await this.host()).click();\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/ngwr-decrypt-text.mjs

@@ -160,7 +160,12 @@ class WrDecryptText {
             const txt = this.text();
             const mode = this.animateOn();
             this.stopInterval();
-            if (mode === 'click') {
+            // The resting state of `click` mode is the scramble — but not for someone who
+            // asked for less motion. `startInterval` short-circuits every TRIGGER to the
+            // plain text, and this is the one path that never reaches it, so a reduced-
+            // motion reader was left staring at permanently scrambled glyphs with no
+            // pointer-free way to undo them.
+            if (mode === 'click' && !this.platform.prefersReducedMotion()) {
                 this.encryptInstantly(txt);
             }
             else {
@@ -393,10 +398,10 @@ class WrDecryptText {
         })
             .join('');
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: WrDecryptText, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.1", type: WrDecryptText, isStandalone: true, selector: "wr-decrypt-text", inputs: { text: { classPropertyName: "text", publicName: "text", isSignal: true, isRequired: true, transformFunction: null }, speed: { classPropertyName: "speed", publicName: "speed", isSignal: true, isRequired: false, transformFunction: null }, maxIterations: { classPropertyName: "maxIterations", publicName: "maxIterations", isSignal: true, isRequired: false, transformFunction: null }, sequential: { classPropertyName: "sequential", publicName: "sequential", isSignal: true, isRequired: false, transformFunction: null }, revealDirection: { classPropertyName: "revealDirection", publicName: "revealDirection", isSignal: true, isRequired: false, transformFunction: null }, useOriginalCharsOnly: { classPropertyName: "useOriginalCharsOnly", publicName: "useOriginalCharsOnly", isSignal: true, isRequired: false, transformFunction: null }, characters: { classPropertyName: "characters", publicName: "characters", isSignal: true, isRequired: false, transformFunction: null }, animateOn: { classPropertyName: "animateOn", publicName: "animateOn", isSignal: true, isRequired: false, transformFunction: null }, clickMode: { classPropertyName: "clickMode", publicName: "clickMode", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "mouseenter": "onMouseEnter()", "mouseleave": "onMouseLeave()", "click": "onClick()" }, classAttribute: "wr-decrypt-text" }, ngImport: i0, template: "<span class=\"wr-decrypt-text__sr-only\">{{ text() }}</span>\n<span aria-hidden=\"true\">\n  @for (c of chars(); track $index) {\n    <span [class]=\"c.revealed ? 'wr-decrypt-text__char' : 'wr-decrypt-text__char wr-decrypt-text__char--encrypted'\">{{\n      c.ch\n    }}</span>\n  }\n</span>\n", styles: [".wr-decrypt-text{display:inline-block;white-space:pre-wrap}.wr-decrypt-text__sr-only{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0,0,0,0);border:0}.wr-decrypt-text__char{display:inline}\n"], encapsulation: i0.ViewEncapsulation.None });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: WrDecryptText, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.2", type: WrDecryptText, isStandalone: true, selector: "wr-decrypt-text", inputs: { text: { classPropertyName: "text", publicName: "text", isSignal: true, isRequired: true, transformFunction: null }, speed: { classPropertyName: "speed", publicName: "speed", isSignal: true, isRequired: false, transformFunction: null }, maxIterations: { classPropertyName: "maxIterations", publicName: "maxIterations", isSignal: true, isRequired: false, transformFunction: null }, sequential: { classPropertyName: "sequential", publicName: "sequential", isSignal: true, isRequired: false, transformFunction: null }, revealDirection: { classPropertyName: "revealDirection", publicName: "revealDirection", isSignal: true, isRequired: false, transformFunction: null }, useOriginalCharsOnly: { classPropertyName: "useOriginalCharsOnly", publicName: "useOriginalCharsOnly", isSignal: true, isRequired: false, transformFunction: null }, characters: { classPropertyName: "characters", publicName: "characters", isSignal: true, isRequired: false, transformFunction: null }, animateOn: { classPropertyName: "animateOn", publicName: "animateOn", isSignal: true, isRequired: false, transformFunction: null }, clickMode: { classPropertyName: "clickMode", publicName: "clickMode", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "mouseenter": "onMouseEnter()", "mouseleave": "onMouseLeave()", "click": "onClick()" }, classAttribute: "wr-decrypt-text" }, ngImport: i0, template: "<span class=\"wr-decrypt-text__sr-only\">{{ text() }}</span>\n<span aria-hidden=\"true\">\n  @for (c of chars(); track $index) {\n    <span [class]=\"c.revealed ? 'wr-decrypt-text__char' : 'wr-decrypt-text__char wr-decrypt-text__char--encrypted'\">{{\n      c.ch\n    }}</span>\n  }\n</span>\n", styles: [".wr-decrypt-text{display:inline-block;white-space:pre-wrap}.wr-decrypt-text__sr-only{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0,0,0,0);border:0}.wr-decrypt-text__char{display:inline}\n"], encapsulation: i0.ViewEncapsulation.None });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: WrDecryptText, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: WrDecryptText, decorators: [{
             type: Component,
             args: [{ selector: 'wr-decrypt-text', encapsulation: ViewEncapsulation.None, host: {
                         class: 'wr-decrypt-text',