@eifi1/ui-kit 0.53.0 → 0.55.0

package/src/i18n/plurals.ts

@@ -1,86 +0,0 @@
-/**
- * Every plural category a language has, filled from the key family's `_other` — for an
- * app's i18next catalogue, before i18next sees it.
- *
- * The apps write English's two forms, `key_one` and `key_other`, in every language: that
- * is the key set their parity tests hold each catalogue to, and no translator should have
- * to know which categories CLDR assigns. But CLDR gives French, Italian and Spanish a
- * third, `many` (1 000 000, « 1,5 million »), and i18next asks for `key_many` there and
- * nothing else — so without it the count fell down the fallback chain and printed German
- * in a French sentence. Kurvenschmiede found it and filled the gap in memory; kastlan
- * wrote the same function again (0.19 adoption). This is that function, once.
- *
- * `_other` is the right stand-in: CLDR's `many` shares its wording with `other` in all
- * three. An ordinal family (`key_ordinal_one`, `…_ordinal_other`) is filled from the
- * language's ORDINAL categories. A category the catalogue already has is left alone, and
- * the input is not changed: a new tree comes back. A locale `Intl` cannot read (`""`,
- * `"x"` — a backend `parse` called without a language) adds nothing rather than throwing,
- * so one odd call cannot fail a whole namespace load (kastlan, 0.20 adoption).
- *
- *     i18n.addResourceBundle(lng, "translation", withAllPlurals(catalogue, lng));
- *     // i18next-http-backend: { parse: (data, lng) => withAllPlurals(JSON.parse(data), lng) }
- */
-export function withAllPlurals<T extends Record<string, unknown>>(
-  catalogue: T,
-  locale: string,
-): T & Record<string, unknown> {
-  const cardinal = pluralCategories(locale, "cardinal");
-  const ordinal = pluralCategories(locale, "ordinal");
-  const fill = (tree: Record<string, unknown>): Record<string, unknown> => {
-    const out: Record<string, unknown> = {};
-    for (const [key, value] of Object.entries(tree)) {
-      out[key] =
-        value !== null && typeof value === "object" && !Array.isArray(value)
-          ? fill(value as Record<string, unknown>)
-          : value;
-    }
-    for (const [key, value] of Object.entries(tree)) {
-      if (!key.endsWith("_other") || typeof value !== "string") continue;
-      const base = key.slice(0, -"_other".length);
-      const categories = base.endsWith("_ordinal") ? ordinal : cardinal;
-      for (const category of categories) {
-        const name = `${base}_${category}`;
-        if (!(name in out)) out[name] = value;
-      }
-    }
-    return out;
-  };
-  return fill(catalogue) as T & Record<string, unknown>;
-}
-
-function pluralCategories(locale: string, type: Intl.PluralRuleType): readonly string[] {
-  try {
-    return new Intl.PluralRules(locale, { type }).resolvedOptions().pluralCategories;
-  } catch {
-    return [];
-  }
-}
-
-/**
- * A word in the plural forms a count can ask for, `other` required: an app's
- * `key_one` / `key_other` pair, or any of CLDR's categories (`zero`, `one`, `two`, `few`,
- * `many`). A category left out reads `other`, the stand-in {@link withAllPlurals} fills
- * a catalogue with — so English's two forms serve every language, as in the apps'
- * catalogues.
- *
- *     { one: t("planUsage.budget_one"), other: t("planUsage.budget_other") }
- */
-export type PluralForms = { other: string } & Partial<Record<Intl.LDMLPluralRule, string>>;
-
-/**
- * The form of `forms` that `count` takes in `locale` — CLDR's cardinal category for it,
- * through `Intl.PluralRules`, else `other`. A locale `Intl` cannot read reads as the
- * runtime's, as everywhere the kit formats (and `undefined` is the runtime's). For the
- * kit's own parts that put an app's word after a count: `planColumn`'s usage.
- */
-export function pluralForm(count: number, forms: PluralForms, locale?: string): string {
-  return forms[pluralCategory(count, locale)] ?? forms.other;
-}
-
-function pluralCategory(count: number, locale: string | undefined): Intl.LDMLPluralRule {
-  try {
-    return new Intl.PluralRules(locale).select(count);
-  } catch {
-    return new Intl.PluralRules().select(count);
-  }
-}

package/src/i18n/review.ts

@@ -1,475 +0,0 @@
-import { legalOperatorText } from "../components/legal";
-import type { LegalOperator, LegalOperatorText } from "../components/legal";
-import type { UiKitLabels } from "./kit-labels";
-
-/**
- * The kit's words as a flat `key → text` list, for an app's translation review.
- *
- * keksdose reviews its own locale bundles on its /translations page — one verdict per
- * locale and key, stored with the text the reviewer saw, so a later change re-opens it.
- * The kit's words appear on the same screens but live in TypeScript, not in the app's
- * bundles, and 143 of them are functions (`(count) => "3 results"`; 0.28.0, every one
- * listed in {@link KIT_LABEL_SAMPLES}), which a bundle flattener skips. This turns a
- * label tree into rows that page can join on.
- *
- * - A string label is one row under its dot path: `common.close`. An array of words
- *   (weekday names) is one row per entry: `miniCalendar.weekdays.0`.
- * - A function label is called with fixed samples. Text arguments are i18next-style
- *   placeholders (`{{name}}`), so a translation that drops one is caught by the same
- *   placeholder check the app runs on its own strings. Counts are real numbers, twice
- *   where the wording may depend on them — 1 and 3 — so a reviewer sees singular and
- *   plural. The key names the sample: `combobox.resultCount(1)`,
- *   `shareCard.removeConfirm(name)`, `serverWake.waking()`.
- * - The legal sections that name the operator (0.28) take one object; its sample is a
- *   placeholder per field and the key calls it `operator`:
- *   `legal.sections.privacy.controller.body(operator)`. Pass the app's operator in
- *   `options` and those rows read the real sentence — same keys — so the lawyer
- *   reviewing the `legal` area reads what the page says:
- *
- *       kitLabelStrings(UI_KIT_LABELS_DE_CH, { operator: OPERATOR, locale: "de-CH" })
- *
- * Keys depend only on the samples, never on the locale, so the rows of `de-CH` and of the
- * English reference line up key by key. Pass exactly the tree the app hands
- * `UiKitProvider` — its overrides included — and review what users see:
- *
- *     kitLabelStrings(UI_KIT_LABELS_DE_CH)          // the rows for de-CH
- *     kitLabelStrings(DEFAULT_UI_KIT_LABELS)        // the English reference
- *
- * A label that throws on its sample becomes a row starting with "⚠", so one broken
- * override shows up on the page instead of taking the page down.
- */
-export function kitLabelStrings(labels: UiKitLabels, options: KitLabelStringsOptions = {}): Record<string, string> {
-  const out: Record<string, string> = {};
-  const operator = options.operator && legalOperatorText(options.operator, options.locale);
-  const walk = (node: unknown, path: string) => {
-    if (typeof node === "string") {
-      out[path] = node;
-    } else if (typeof node === "function") {
-      for (const args of KIT_LABEL_SAMPLES[path] ?? [[]]) {
-        // The key is the SAMPLE's (`…body(operator)`), whatever the label is called with,
-        // so rows with and without the app's operator join on the same keys.
-        const called = operator ? args.map((arg) => (arg === LEGAL_OPERATOR_SAMPLE ? operator : arg)) : args;
-        out[
-          `${path}(${args
-            .map(sampleName)
-            .filter((a) => a !== "")
-            .join(", ")})`
-        ] = render(node as (...args: unknown[]) => unknown, called);
-      }
-    } else if (node !== null && typeof node === "object") {
-      for (const [key, value] of Object.entries(node)) walk(value, path ? `${path}.${key}` : key);
-    }
-  };
-  walk(labels, "");
-  return out;
-}
-
-export interface KitLabelStringsOptions {
-  /**
-   * The app's operator (0.28): the legal sections that name it — the imprint's operator
-   * and contact, the controller, the privacy contact, the governing law — are rendered
-   * with the real values instead of `{{name}}`-style placeholders, so a reviewer (the
-   * lawyer, under the `legal` area) reads the sentence the page shows. The keys do not
-   * change: `legal.sections.impressum.operator.body(operator)` either way.
-   */
-  operator?: LegalOperator;
-  /** The language the operator's country is named in — the locale these rows are
-   *  for ("de-CH" → "Schweiz"). Default English. */
-  locale?: string;
-}
-
-function render(label: (...args: unknown[]) => unknown, args: readonly unknown[]): string {
-  try {
-    return String(label(...args));
-  } catch (error) {
-    return `⚠ ${error instanceof Error ? error.message : String(error)}`;
-  }
-}
-
-/** How a sample argument is written in the key: a placeholder by its name, a number as
- *  itself, an empty string as `""`, a missing optional argument not at all. */
-function sampleName(arg: unknown): string {
-  if (arg === undefined) return "";
-  if (arg === LEGAL_OPERATOR_SAMPLE) return "operator";
-  if (typeof arg === "string") return /^\{\{(\w+)\}\}$/.exec(arg)?.[1] ?? JSON.stringify(arg);
-  return String(arg);
-}
-
-const one = [[1], [3]] as const;
-
-/**
- * The legal sections' operator (0.28) as placeholders, one per field — so a translation
- * that drops the city or the email is caught by the same check as a dropped `{{name}}`
- * anywhere else. Named `operator` in the key; {@link kitLabelStrings}' `operator` option
- * swaps the app's real values in for it.
- */
-const LEGAL_OPERATOR_SAMPLE: LegalOperatorText = Object.freeze({
-  name: "{{name}}",
-  postalCode: "{{postalCode}}",
-  city: "{{city}}",
-  region: "{{region}}",
-  country: "{{country}}",
-  email: "{{email}}",
-  bindingLanguage: "{{bindingLanguage}}",
-});
-const operatorSample = [[LEGAL_OPERATOR_SAMPLE]] as const;
-
-/**
- * The sample arguments of every function label in {@link UiKitLabels}, by dot path.
- * `src/i18n/__tests__/review.test.ts` fails when a function label has no entry here, so
- * a new one cannot ship un-reviewable.
- */
-export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unknown[])[]>> = {
-  "common.fieldValue": [["{{field}}", "{{value}}"]],
-  "common.aboutField": [["{{field}}"]],
-  "dataTable.filterResults": [
-    [1, 1],
-    [3, 12],
-  ],
-  "dataTable.sortedAscending": [["{{column}}"]],
-  "dataTable.sortedDescending": [["{{column}}"]],
-  "dataTable.sortCleared": [["{{column}}"]],
-  "dataTable.pageChanged": [[2, 5]],
-  "dataTable.pageRange": [[1, 25, 1240]],
-  "dataTable.rowCount": [[1], [1240]],
-  "dataTable.columnsCount": [[3, 8]],
-  "dataTable.filterColumn": [
-    ["{{column}}", false],
-    ["{{column}}", true],
-  ],
-  "miniCalendar.day": [["{{date}}"]],
-  "miniCalendar.startSelected": [["{{date}}"]],
-  "miniCalendar.rangeSelected": [["{{from}}", "{{to}}"]],
-  "calendarHeatmap.day": [["{{date}}", "{{value}}"]],
-  "calendarHeatmap.truncated": one,
-  "monthPicker.month": [["{{monthYear}}"]],
-  "combobox.create": [["{{query}}"]],
-  "combobox.selectedCount": one,
-  "combobox.resultCount": one,
-  "combobox.minChars": one,
-  "multiSelect.selectedCount": one,
-  "chipInput.added": [["{{value}}"]],
-  "chipInput.removed": [["{{value}}"]],
-  "chipInput.atLimit": one,
-  "chipInput.duplicate": [["{{value}}"]],
-  "tabs.remove": [["{{tab}}"]],
-  "appShell.toggleGroup": [["{{group}}"]],
-  "topBar.role": [["{{role}}"]],
-  "topBar.languageCurrent": [["{{name}}"]],
-  "file.size": [[2_500_000]],
-  "wizard.step": [[2, 4]],
-  "tour.step": [[2, 4]],
-  "tour.backToStep": [["{{title}}"]],
-  "globalSearch.shortcut": [["{{keys}}"]],
-  "pieChart.slice": [["{{label}}", "{{value}}", "{{percent}}"]],
-  "pieChart.sliceShare": [["{{label}}", "{{percent}}"]],
-  // The second form is `shareInValue` (0.53): no share, and nothing round it.
-  "treemap.tile": [
-    ["{{name}}", "{{value}}", "{{share}}"],
-    ["{{name}}", "{{value}}", ""],
-  ],
-  "treemap.group": [
-    ["{{name}}", "{{value}}", "{{share}}"],
-    ["{{name}}", "{{value}}", ""],
-  ],
-  "treemap.inGroup": [["{{name}}", "{{group}}"]],
-  "sparkline.rising": [["{{first}}", "{{last}}"]],
-  "sparkline.falling": [["{{first}}", "{{last}}"]],
-  "sparkline.flat": [["{{value}}"]],
-  "sparkline.single": [["{{value}}"]],
-  "sparkline.named": [["{{name}}", "{{summary}}"]],
-  "statTile.increase": [["{{amount}}"]],
-  "statTile.decrease": [["{{amount}}"]],
-  "statTile.better": [["{{change}}"]],
-  "statTile.worse": [["{{change}}"]],
-  "signaturePad.viewTyped": [["{{name}}"]],
-  "passwordStrength.announcement": [["{{level}}"]],
-  "passwordStrength.ruleLength": [[12]],
-  "passwordStrength.optional": [["{{rule}}"]],
-  "passwordStrength.tooLong": [[72]],
-  "dangerConfirm.phrase": [["{{phrase}}"]],
-  "dangerConfirm.needsPhrase": [["{{phrase}}"]],
-  "iconPicker.resultCount": one,
-  "filePicker.rejectedType": [["{{name}}"]],
-  "filePicker.rejectedTypeOnly": [["{{accept}}", "{{name}}"]],
-  "filePicker.rejectedSize": [["{{name}}", "{{maxSize}}"]],
-  "filePicker.rejectedCount": [
-    ["{{name}}", 1],
-    ["{{name}}", 3],
-  ],
-  "filePicker.rejectedInvalid": [["{{name}}"]],
-  "filePicker.rejectedMany": one,
-  "filePicker.rejectedPick": one,
-  "filePicker.selected": [
-    [1, "{{firstName}}"],
-    [3, "{{firstName}}"],
-  ],
-  "filePicker.remove": [["{{name}}"]],
-  "filePicker.removed": [["{{name}}"]],
-  "filePicker.hint": [["{{accept}}"], [""]],
-  "measuredGrid.removeRow": [[3]],
-  "measuredGrid.cell": [["{{column}}", 3]],
-  "measuredGrid.lineError": [[3]],
-  "measuredGrid.points": one,
-  "measuredGrid.problems": one,
-  "feedbackAttachment.attachmentRemoveFile": [["{{name}}"]],
-  "feedbackAttachment.attachmentLimit": one,
-  "feedbackAttachment.attachmentUploadFailed": [["{{name}}"]],
-  "feedbackComposer.sendHint": [["{{modifier}}"]],
-  "feedbackDialog.submitHint": [[true], [false]],
-  "feedbackToast.attachmentTooMany": one,
-  "feedbackToast.statusChanged": [["{{status}}", "{{title}}"]],
-  "feedbackToast.statusRestored": [["{{status}}", "{{title}}"]],
-  "feedbackPage.userFallback": [[42]],
-  // A real value, not a placeholder: the chip upper-cases what it is given, and
-  // "{{ENVIRONMENT}}" would read as a placeholder of that name.
-  "feedbackPage.environment": [["dev"]],
-  "feedbackPage.reworkChip": one,
-  "feedbackDetail.download": [["{{name}}"]],
-  "feedbackDetail.resolvedAt": [["{{date}}"]],
-  "feedbackPublic.total": one,
-  "feedbackPublic.comments": one,
-  "feedbackPublic.votes": one,
-  "feedbackPublic.filedBy": [["{{name}}"]],
-  "feedbackPublic.page": [[3]],
-  "accountSettings.passkeys.renameItem": [["{{name}}"]],
-  "accountSettings.passkeys.renameField": [["{{name}}"]],
-  "accountSettings.passkeys.deleteItem": [["{{name}}"]],
-  "accountSettings.passkeys.deleteConfirm": [["{{name}}"]],
-  "accountSettings.passkeys.created": [["{{date}}"]],
-  "accountSettings.passkeys.lastUsed": [["{{date}}"]],
-  "confirmDialog.typed": [["{{text}}"]],
-  "floatingPanel.badge": one,
-  "bulkActionBar.selected": one,
-  "form.submitShortcut": [[true], [false]],
-  "lineItems.remove": [[3]],
-  "lineItems.confirmRemove": [[3]],
-  "lineItems.row": [[3]],
-  "lineItems.cell": [["{{column}}", 3]],
-  "progressBar.overLimit": [["{{amount}}"]],
-  "signedAmount.positive": [["{{amount}}"]],
-  "signedAmount.negative": [["{{amount}}"]],
-  "errorBoundary.reportedAs": [["{{reference}}"]],
-  "authedImage.failedImage": [["{{alt}}"]],
-  "imageGrid.item": [[2, 5]],
-  "imageGrid.actions": [["{{name}}"]],
-  "lightbox.counter": [[2, 5]],
-  "lightbox.position": [[2, 5]],
-  "shareCard.roleOf": [["{{name}}"]],
-  "shareCard.teamHint": [["{{name}}"]],
-  "shareCard.removeConfirm": [["{{name}}"]],
-  "shareCard.revokePendingConfirm": [["{{name}}"]],
-  "serverWake.waking": [["{{appName}}"], [undefined]],
-  "translationReview.filterCount": [
-    ["{{status}}", 1],
-    ["{{status}}", 3],
-  ],
-  "translationReview.placeholdersOnly": one,
-  "translationReview.progress": [
-    [1, 1],
-    [3, 12],
-  ],
-  "translationReview.localeProgress": [[3, 12]],
-  "translationReview.placeholderMismatch": [["{{reference}}", "{{text}}"]],
-  "translationReview.lastApproved": [["{{name}}", "{{date}}"]],
-  "translationReview.lastFlagged": [["{{name}}", "{{date}}"]],
-  "translationReview.scope": [["{{areas}}"]],
-  "translationReview.exportCorrections": [[0], [1], [3]],
-  "translationReview.approvedToast": one,
-  "translationReview.clearedToast": one,
-  "translationReview.groupCount": [
-    [1, 12],
-    [3, 12],
-  ],
-  "translationReview.approveGroup": one,
-  "translationReview.confirmGroup": [
-    [1, "{{group}}"],
-    [3, "{{group}}"],
-  ],
-  "characterCount.count": [[12, 80]],
-  "characterCount.remaining": one,
-  "inlineEdit.edit": [["{{label}}"]],
-  "ibanInput.country": [["{{code}}"]],
-  "ibanInput.length": [[20, 21]],
-  "rowActions.actionsFor": [["{{name}}"]],
-  "rowActions.confirmTitle": [["{{action}}", "{{name}}"], ["{{action}}"]],
-  "columnMapper.readError": [["{{name}}"]],
-  "columnMapper.summary": [
-    [1, 1],
-    [3, 12],
-  ],
-  "columnMapper.unreadCount": one,
-  "columnMapper.unreadLine": [[3]],
-  "columnMapper.unreadMore": one,
-  "columnMapper.columnN": [[3]],
-  "columnMapper.roleOf": [["{{column}}"]],
-  "columnMapper.requiredRole": [["{{role}}"]],
-  "columnMapper.requiredRoleShort": [["{{role}}"]],
-  "columnMapper.previewOf": [
-    [1, 12],
-    [10, 250],
-  ],
-  "columnMapper.oneOf": [["{{roles}}"]],
-  "columnMapper.missing": [["{{roles}}"]],
-  "legal.sections.impressum.operator.body": operatorSample,
-  "legal.sections.impressum.contact.body": operatorSample,
-  "legal.sections.privacy.controller.body": operatorSample,
-  "legal.sections.privacy.contact.body": operatorSample,
-  "legal.sections.terms.law.body": operatorSample,
-  // 0.28.1: the binding language, named in the reader's language.
-  "legal.sections.terms.language.body": operatorSample,
-  "legal.translation.note": operatorSample,
-  "legal.translation.show": operatorSample,
-  // 0.51.3: the as-of line, with the date already written out.
-  "legal.updated": [["{{date}}"]],
-  // 0.51.4: a limited list's "Show all (n)", with the whole list's count.
-  "list.showAll": [[12], [1240]],
-  // 0.29.0: the sign-in and sign-up parts (docs/auth-harmonization.md).
-  "signIn.tagHint": [["{{taggedAddress}}"]],
-  "register.emailTagUse": [["{{address}}"]],
-  "forgotPassword.sent": [["{{email}}"]],
-  "resetPassword.intro": [["{{email}}"]],
-  "verifyEmail.resendIn": [[30]],
-  "acceptInvitation.joined": [["{{name}}"]],
-  "companySwitcher.current": [["{{name}}"]],
-  // 0.30.0: the user administration and the account's own settings
-  // (docs/user-admin-harmonization.md). `rateLimited` with and without a wait.
-  "signIn.recoveryCodeHint": [[16]],
-  "signIn.rateLimited": [[], [30], [300]],
-  "register.rateLimited": [[], [30], [300]],
-  "forgotPassword.rateLimited": [[], [30], [300]],
-  "resetPassword.rateLimited": [[], [30], [300]],
-  "verifyEmail.rateLimited": [[], [30], [300]],
-  "emailChange.emailTagUse": [["{{address}}"]],
-  "emailChange.pending": [["{{newEmail}}"]],
-  "emailChange.pendingHint": [["{{currentEmail}}"]],
-  "emailChange.confirmed": [["{{email}}"]],
-  "emailChange.rateLimited": [[], [30], [300]],
-  "sessions.lastActive": [["{{when}}"]],
-  "sessions.ip": [["{{address}}"]],
-  "sessions.revokeItem": [["{{device}}"]],
-  "notifications.quietDescription": [[false], [true], [false, true], [true, true]],
-  "notifications.quietZone": [["{{zone}}"]],
-  "notifications.bellUnread": one,
-  "notifications.iosInstall": [["{{app}}"]],
-  "notifications.testSent": one,
-  "notifications.explainerBody": [["{{app}}"]],
-  "notifications.added": [["{{date}}"]],
-  "notifications.lastDelivery": [["{{date}}"]],
-  "notifications.failures": one,
-  "notifications.removeItem": [["{{device}}"]],
-  "notifications.unsubscribeAbout": [["{{type}}"]],
-  "notifications.stopAll": [["{{app}}"]],
-  "notifications.stoppedAll": [["{{app}}"]],
-  "notifications.stoppedHint": [["{{accountMail}}", "{{turnBackOn}}"]],
-  "deleteAccount.afterDays": [[1], [30]],
-  "deleteAccount.handOver": [[1], [3]],
-  "deleteAccount.lastAdminOf": [["{{companies}}"]],
-  "deleteAccount.rateLimited": [[], [30], [300]],
-  "dataExport.rateLimited": [[], [30], [300]],
-  "userRoster.actionsFor": [["{{name}}"]],
-  "roleSelect.roleOf": [["{{name}}"]],
-  "roleSelect.unavailable": [["{{role}}", "{{reason}}"]],
-  "adminActionLog.by": [["{{actor}}"]],
-  "adminActionLog.filteredTo": [["{{target}}"]],
-  "adminActionLog.filterBy": [["{{target}}"]],
-  // 0.45.0 (admin §9.4): a company rename that logged both names.
-  "adminActionLog.renamedFromTo": [["{{from}}", "{{to}}"]],
-  "transferOwnership.title": [["{{name}}"]],
-  "transferOwnership.unavailable": [["{{account}}", "{{reason}}"]],
-  "invitations.sent": [["{{date}}"]],
-  "invitations.expires": [["{{date}}"]],
-  "invitations.invitedBy": [["{{name}}"]],
-  "invitations.resend": [["{{email}}"]],
-  "invitations.revoke": [["{{email}}"]],
-  "invitations.linkReady": [["{{email}}"]],
-  "invitations.notSent": [["{{email}}"]],
-  "accountState.deletionOn": [["{{date}}"]],
-  // 0.31.0: the settings shell, the landing page and the demo
-  // (docs/settings-harmonization.md, docs/landing-demo-harmonization.md). An optional
-  // argument both given and left out: the subject without an app name, the refusal
-  // without a `Retry-After`.
-  "settings.noMatches": [["{{query}}"]],
-  "settings.matchCount": one,
-  "landing.accessSubject": [["{{app}}"], [undefined]],
-  "demo.rateLimited": [[], [1], [3]],
-  "demo.hoursLeft": [
-    [1, 1],
-    [3, 12],
-  ],
-  "demo.minutesLeft": one,
-  // 0.32.0: the subscription parts (docs/billing-harmonization.md §7). A trial or a grant
-  // ending today, tomorrow and in five days; the guest's notice with and without the
-  // item's name.
-  "billing.choose": [["{{plan}}"]],
-  "billing.upgrade": [["{{plan}}"]],
-  "billing.downgrade": [["{{plan}}"]],
-  "billing.trialEnding": [[0], [1], [5]],
-  "billing.grantEnding": [[0], [1], [5]],
-  "billing.guestReadOnly": [["{{item}}"], [undefined]],
-  "billing.usage": [["{{used}}", "{{limit}}"]],
-  "billing.contactSubject": [["{{dimension}}"]],
-  "billing.waitingChanges": one,
-  // 0.33.0: the limit's figure line (§14.11) and the operator's plan parts (§14.12).
-  "billing.limitUsageLine": [["{{dimension}}", "{{used}}", "{{limit}}"]],
-  // 0.39: PlanSwitchConfirm's two lines with figures (§15.2.10).
-  "billing.switchFromTo": [["{{from}}", "{{to}}"]],
-  "billing.switchNextCharge": [["{{date}}"]],
-  // 0.42 (§16): the buyer's name, or none once they are gone; the cancel's period end.
-  "billing.buyerHolds": [["{{buyer}}"], [undefined]],
-  "billing.paymentFailedAskBuyer": [["{{buyer}}"], [undefined]],
-  "billing.cancelConfirmBody": [["{{date}}"]],
-  "billing.portalOpensNewTab": [
-    ["{{provider}}", "{{app}}"],
-    ["{{provider}}", undefined],
-  ],
-  "planChange.current": [["{{plan}}"]],
-  "planChange.changed": [["{{from}}", "{{to}}"]],
-  "planChange.set": [["{{to}}"]],
-  "planChange.untilDone": [["{{date}}"]],
-  "planChange.usageOf": [["{{used}}", "{{limit}}", "{{dimension}}"]],
-  // 0.42.0 (docs/admin-harmonization.md §3.1): the menu row's count, the 403 page's app,
-  // the users tile's new accounts.
-  "adminArea.waiting": one,
-  // 0.45.0 (admin §9.3.4): an IconButton's name with its waiting count.
-  "adminArea.waitingLabel": [
-    ["{{label}}", 1],
-    ["{{label}}", 3],
-  ],
-  // 0.45.0 (admin §9.2.4): the test mail's transport, masked address and limiter.
-  "mailTestCard.transport": [["{{backend}}"]],
-  "mailTestCard.sent": [["{{address}}"]],
-  "mailTestCard.rateLimited": [[], [30], [300]],
-  "adminArea.forbiddenBody": [["{{app}}"]],
-  "adminArea.tiles.usersNew": one,
-  // 0.42.0 (docs/top-bar-harmonization.md §3.1): the sync indicator's counts, its time, the
-  // state joined to its hint or to the app's scope; the dev plan and the role to go back to.
-  "topBarParts.sync.blocked": one,
-  "topBarParts.sync.pending": one,
-  "topBarParts.sync.syncedAt": [["{{time}}"]],
-  "topBarParts.sync.withHint": [["{{state}}", "{{hint}}"]],
-  "topBarParts.sync.scoped": [["{{scope}}", "{{state}}"]],
-  "topBarParts.sync.waitingShort": one,
-  "topBarParts.dev.plan": [["{{plan}}"]],
-  "topBarParts.dev.backTo": [["{{role}}"]],
-  // 0.43.0 (docs/tours-harmonization.md §3, §8): the tours page's counts, its group
-  // option, the completion day and a reset's day and reason.
-  "tourCatalogue.groupAll": one,
-  "tourCatalogue.groupOption": [
-    ["{{group}}", 1],
-    ["{{group}}", 3],
-  ],
-  "tourCatalogue.stateAll": one,
-  "tourCatalogue.stateTodo": one,
-  "tourCatalogue.stateDone": one,
-  "tourCatalogue.showing": [[3, 16]],
-  "tourCatalogue.resetOn": [["{{date}}", "{{reason}}"]],
-  "tourCatalogue.points": one,
-  "tourCatalogue.steps": one,
-  "tourCatalogue.duration": one,
-  "tourCatalogue.completedOn": [["{{date}}"]],
-  // 0.45.0 (docs/local-first-harmonization.md §1.6): the sign-out question's count, in
-  // both word sets.
-  "signOutPending.lost": one,
-  "signOutPending.kept": one,
-};