vectis-ui 0.1.0 → 0.8.0

package/dist/i18n/fr.d.ts

@@ -1,18 +1,2 @@
-import { VectisMessages } from './types.js';
-/**
- * French. Nothing reaches this file unless it is asked for, so a project that does not
- * use it never carries it: the library is packaged one module at a time, and a module
- * nobody imports is left out.
- *
- * Turning it on and adding a language the library does not ship at all are the SAME
- * gesture. There are deliberately not two kinds of dictionary, one blessed and one added
- * by hand:
- *
- *     import { fr, registerMessages, setLocale } from 'vectis-ui'
- *     registerMessages('fr', fr)
- *     setLocale('fr-FR')
- *
- * The curly apostrophes below are deliberate and are part of the text: some tests check
- * these words letter for letter, and a straight apostrophe is a different letter.
- */
-export declare const fr: VectisMessages;
+import { Messages } from './types.js';
+export declare const fr: Messages;

package/dist/i18n/fr.js

@@ -5,6 +5,7 @@ var e = {
 		clear: "Effacer",
 		close: "Fermer",
 		dismiss: "Retirer",
+		remove: (e) => `Retirer ${e}`,
 		cancel: "Annuler",
 		confirm: "OK"
 	},
@@ -12,8 +13,7 @@ var e = {
 		label: "Pagination",
 		previous: "Page précédente",
 		next: "Page suivante",
-		page: (e) => `Page ${e}`,
-		hiddenPages: "Pages masquées"
+		page: (e) => `Page ${e}`
 	},
 	tabs: {
 		label: "Onglets",
@@ -27,8 +27,7 @@ var e = {
 	sideNavigation: { label: "Navigation" },
 	combobox: {
 		empty: "Aucun résultat",
-		clear: "Effacer la sélection",
-		remove: (e) => `Retirer ${e}`
+		clear: "Effacer la sélection"
 	},
 	dataTable: {
 		empty: "Aucune donnée",
@@ -84,6 +83,7 @@ var e = {
 		label: (e) => `Raccourci clavier : ${e}`
 	},
 	datePicker: {
+		label: "Sélecteur de date",
 		previousMonth: "Mois précédent",
 		nextMonth: "Mois suivant",
 		previousYear: "Année précédente",
@@ -93,41 +93,40 @@ var e = {
 	},
 	dateInput: {
 		clear: "Effacer la date",
-		open: "Ouvrir le calendrier",
-		label: "Choisir une date"
+		openPicker: "Ouvrir le calendrier",
+		pickerLabel: "Choisir une date"
 	},
 	timePicker: {
+		label: "Sélecteur d'heure",
 		meridiem: "AM ou PM",
 		am: "AM",
 		pm: "PM",
 		selectHour: "Sélectionner l’heure",
-		selectMinute: "Sélectionner les minutes",
-		hourStep: "Sélection de l’heure",
-		minuteStep: "Sélection des minutes",
+		selectMinutes: "Sélectionner les minutes",
+		choosingHour: "Sélection de l’heure",
+		choosingMinutes: "Sélection des minutes",
 		hour: "Heure",
 		minutes: "Minutes",
-		hoursValue: (e) => `${e} heures`,
+		hourValue: (e) => `${e} heures`,
 		minutesValue: (e) => `${e} minutes`
 	},
 	timeInput: {
 		clear: "Effacer l'heure",
-		openList: "Ouvrir la liste des heures",
 		openPicker: "Ouvrir le sélecteur d’heure",
-		listLabel: "Heures disponibles",
 		pickerLabel: "Choisir une heure",
-		maskPlaceholder: "hh:mm"
+		meridiemValue: (e) => `AM ou PM : ${e}`,
+		maskPlaceholder: "hh:mm",
+		unavailable: "Cette heure n'est pas disponible."
 	},
 	fileInput: {
-		attach: "Choisir des fichiers",
+		openPicker: "Choisir des fichiers",
 		clear: "Effacer les fichiers",
-		remove: (e) => `Retirer ${e}`,
 		files: (e) => `${e} fichier${e > 1 ? "s" : ""}`,
 		placeholder: "Aucun fichier sélectionné"
 	},
 	filePicker: {
 		browse: "Parcourir les fichiers",
 		or: "ou",
-		remove: (e) => `Retirer ${e}`,
 		list: "Fichiers sélectionnés"
 	},
 	carousel: {
@@ -164,10 +163,10 @@ var e = {
 		allDay: "Journée",
 		moreEvents: (e) => `+${e} autre${e > 1 ? "s" : ""}`,
 		openDay: (e) => `Ouvrir le ${e}`,
-		newEvent: (e) => `Évènement n°${e}`,
+		untitled: "(Sans titre)",
 		eventRoleDescription: "évènement",
-		eventHint: "Appuyez sur Entrée pour saisir cet évènement, puis sur les flèches pour le déplacer et sur Maj avec les flèches pour changer son heure de fin.",
-		grabbed: "Évènement saisi. Utilisez les flèches pour le déplacer, Entrée pour le poser, Échap pour annuler.",
+		eventHint: "Appuyez sur Entrée pour ouvrir cet évènement. Appuyez sur Espace pour le saisir, puis sur les flèches pour le déplacer et sur Maj avec les flèches pour changer son heure de fin.",
+		grabbed: "Évènement saisi. Utilisez les flèches pour le déplacer, Entrée ou Espace pour le poser, Échap pour annuler.",
 		dropped: "Évènement posé.",
 		reverted: "Déplacement annulé. L'évènement est revenu à sa place.",
 		movedTo: (e, t) => `${e} déplacé au ${t}.`

package/dist/i18n/fr.js.map

@@ -1 +1 @@
-{"version":3,"file":"fr.js","names":[],"sources":["../../src/i18n/fr.ts"],"sourcesContent":["import type { VectisMessages } from './types'\n\n/**\n * French. Nothing reaches this file unless it is asked for, so a project that does not\n * use it never carries it: the library is packaged one module at a time, and a module\n * nobody imports is left out.\n *\n * Turning it on and adding a language the library does not ship at all are the SAME\n * gesture. There are deliberately not two kinds of dictionary, one blessed and one added\n * by hand:\n *\n *     import { fr, registerMessages, setLocale } from 'vectis-ui'\n *     registerMessages('fr', fr)\n *     setLocale('fr-FR')\n *\n * The curly apostrophes below are deliberate and are part of the text: some tests check\n * these words letter for letter, and a straight apostrophe is a different letter.\n */\nexport const fr: VectisMessages = {\n  common: {\n    loading: 'Chargement…',\n    clear: 'Effacer',\n    close: 'Fermer',\n    dismiss: 'Retirer',\n    cancel: 'Annuler',\n    confirm: 'OK',\n  },\n  pagination: {\n    label: 'Pagination',\n    previous: 'Page précédente',\n    next: 'Page suivante',\n    page: (page) => `Page ${page}`,\n    hiddenPages: 'Pages masquées',\n  },\n  tabs: {\n    label: 'Onglets',\n    previous: 'Onglets précédents',\n    next: 'Onglets suivants',\n  },\n  breadcrumb: {\n    label: \"Fil d'Ariane\",\n    ellipsis: 'Afficher les pages intermédiaires',\n  },\n  sideNavigation: { label: 'Navigation' },\n  combobox: {\n    empty: 'Aucun résultat',\n    clear: 'Effacer la sélection',\n    remove: (label) => `Retirer ${label}`,\n  },\n  dataTable: {\n    empty: 'Aucune donnée',\n    loading: 'Chargement des données…',\n    searchLabel: 'Rechercher dans le tableau',\n    searchPlaceholder: 'Rechercher…',\n    perPage: 'Lignes par page',\n    perPageValue: (label, value) => `${label} : ${value}`,\n    selectAll: 'Tout sélectionner',\n    selectRow: (index) => `Sélectionner la ligne ${index}`,\n    selection: (count) =>\n      `${count} élément${count > 1 ? 's' : ''} sélectionné${count > 1 ? 's' : ''}`,\n    range: ({ start, end, total }) => `${start}–${end} sur ${total}`,\n    pagination: 'Pagination du tableau',\n  },\n  toaster: { label: 'Notifications' },\n  snackbar: { label: 'Confirmation', action: 'Annuler' },\n  inputOTP: {\n    label: 'Code de vérification',\n    slot: (index, total) => `Caractère ${index} sur ${total}`,\n  },\n  slider: {\n    value: 'Valeur',\n    start: 'Début',\n    end: 'Fin',\n    rangeStart: (label) => `${label} (début)`,\n    rangeEnd: (label) => `${label} (fin)`,\n  },\n  field: {\n    limitExceeded: (max) => `Dépasse la limite de ${max} caractères`,\n  },\n  // The space before the sign is a NON-BREAKING one, as French typography requires and\n  // English does not. It is written as an escape rather than typed in: the linter refuses\n  // the character itself, and it would be indistinguishable from an ordinary space in a\n  // review.\n  progress: { percent: (percent) => `${percent}\\u00A0%`, label: 'Progression' },\n  hotkeys: {\n    command: 'Commande',\n    ctrl: 'Ctrl',\n    alt: 'Alt',\n    shift: 'Maj',\n    windows: 'Win',\n    super: 'Super',\n    enter: 'Entrée',\n    escape: 'Échap',\n    space: 'Espace',\n    backspace: 'Retour arrière',\n    delete: 'Suppr',\n    tab: 'Tab',\n    up: 'Flèche haut',\n    down: 'Flèche bas',\n    left: 'Flèche gauche',\n    right: 'Flèche droite',\n    label: (keys) => `Raccourci clavier : ${keys}`,\n  },\n  datePicker: {\n    previousMonth: 'Mois précédent',\n    nextMonth: 'Mois suivant',\n    previousYear: 'Année précédente',\n    nextYear: 'Année suivante',\n    monthPicker: 'Choix du mois',\n    yearPicker: \"Choix de l'année\",\n  },\n  dateInput: {\n    clear: 'Effacer la date',\n    open: 'Ouvrir le calendrier',\n    label: 'Choisir une date',\n  },\n  timePicker: {\n    meridiem: 'AM ou PM',\n    am: 'AM',\n    pm: 'PM',\n    selectHour: 'Sélectionner l’heure',\n    selectMinute: 'Sélectionner les minutes',\n    hourStep: 'Sélection de l’heure',\n    minuteStep: 'Sélection des minutes',\n    hour: 'Heure',\n    minutes: 'Minutes',\n    hoursValue: (hour) => `${hour} heures`,\n    minutesValue: (minute) => `${minute} minutes`,\n  },\n  timeInput: {\n    clear: \"Effacer l'heure\",\n    openList: 'Ouvrir la liste des heures',\n    openPicker: 'Ouvrir le sélecteur d’heure',\n    listLabel: 'Heures disponibles',\n    pickerLabel: 'Choisir une heure',\n    maskPlaceholder: 'hh:mm',\n  },\n  fileInput: {\n    attach: 'Choisir des fichiers',\n    clear: 'Effacer les fichiers',\n    remove: (name) => `Retirer ${name}`,\n    // The French plural starts at two, the English one at zero — \"0 fichier\" against\n    // \"0 files\". Each language therefore makes the choice on its own, and there is no\n    // shared rule for either to inherit.\n    files: (count) => `${count} fichier${count > 1 ? 's' : ''}`,\n    placeholder: 'Aucun fichier sélectionné',\n  },\n  filePicker: {\n    browse: 'Parcourir les fichiers',\n    or: 'ou',\n    remove: (name) => `Retirer ${name}`,\n    list: 'Fichiers sélectionnés',\n  },\n  carousel: {\n    label: 'Carrousel',\n    roleDescription: 'carrousel',\n    slideRoleDescription: 'diapositive',\n    slides: 'Diapositives',\n    slide: (index, total) => `${index} sur ${total}`,\n    previous: 'Diapositive précédente',\n    next: 'Diapositive suivante',\n    indicators: 'Choisir la diapositive à afficher',\n  },\n  calendar: {\n    label: 'Calendrier',\n    roleDescription: 'calendrier',\n    today: \"Aujourd'hui\",\n    view: 'Affichage',\n    viewDay: 'Jour',\n    view4Days: '4 jours',\n    viewWeek: 'Semaine',\n    viewMonth: 'Mois',\n    viewYear: 'Année',\n    viewCustom: (days) => `${days} jours`,\n    previousDay: 'Jour précédent',\n    nextDay: 'Jour suivant',\n    previousWeek: 'Semaine précédente',\n    nextWeek: 'Semaine suivante',\n    previousMonth: 'Mois précédent',\n    nextMonth: 'Mois suivant',\n    previousYear: 'Année précédente',\n    nextYear: 'Année suivante',\n    previousPeriod: 'Période précédente',\n    nextPeriod: 'Période suivante',\n    allDay: 'Journée',\n    moreEvents: (count) => `+${count} autre${count > 1 ? 's' : ''}`,\n    openDay: (day) => `Ouvrir le ${day}`,\n    newEvent: (index) => `Évènement n°${index}`,\n    eventRoleDescription: 'évènement',\n    eventHint:\n      'Appuyez sur Entrée pour saisir cet évènement, puis sur les flèches pour le déplacer et sur Maj avec les flèches pour changer son heure de fin.',\n    grabbed:\n      'Évènement saisi. Utilisez les flèches pour le déplacer, Entrée pour le poser, Échap pour annuler.',\n    dropped: 'Évènement posé.',\n    reverted: \"Déplacement annulé. L'évènement est revenu à sa place.\",\n    movedTo: (title, when) => `${title} déplacé au ${when}.`,\n  },\n}\n"],"mappings":"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"}
+{"version":3,"file":"fr.js","names":[],"sources":["../../src/i18n/fr.ts"],"sourcesContent":["/**\n * French, opt-in by import: the package ships one module per file, so a project that never\n * imports this one never carries it.\n *\n * Enabling it and adding a language the library does not ship are the SAME gesture — there\n * are deliberately not two kinds of dictionary, one blessed and one hand-added:\n *\n *     import { fr, registerMessages, setLocale } from 'vectis-ui'\n *     registerMessages('fr', fr)\n *     setLocale('fr-FR')\n *\n * TRAP — the curly apostrophes below are part of the text. Some tests assert these strings\n * letter for letter, and a straight apostrophe is a different character.\n */\n\nimport type { Messages } from './types'\n\nexport const fr: Messages = {\n  common: {\n    loading: 'Chargement…',\n    clear: 'Effacer',\n    close: 'Fermer',\n    dismiss: 'Retirer',\n    remove: (name) => `Retirer ${name}`,\n    cancel: 'Annuler',\n    confirm: 'OK',\n  },\n  pagination: {\n    label: 'Pagination',\n    previous: 'Page précédente',\n    next: 'Page suivante',\n    page: (page) => `Page ${page}`,\n  },\n  tabs: {\n    label: 'Onglets',\n    previous: 'Onglets précédents',\n    next: 'Onglets suivants',\n  },\n  breadcrumb: {\n    label: \"Fil d'Ariane\",\n    ellipsis: 'Afficher les pages intermédiaires',\n  },\n  sideNavigation: { label: 'Navigation' },\n  combobox: {\n    empty: 'Aucun résultat',\n    clear: 'Effacer la sélection',\n  },\n  dataTable: {\n    empty: 'Aucune donnée',\n    loading: 'Chargement des données…',\n    searchLabel: 'Rechercher dans le tableau',\n    searchPlaceholder: 'Rechercher…',\n    perPage: 'Lignes par page',\n    perPageValue: (label, value) => `${label} : ${value}`,\n    selectAll: 'Tout sélectionner',\n    selectRow: (index) => `Sélectionner la ligne ${index}`,\n    selection: (count) =>\n      `${count} élément${count > 1 ? 's' : ''} sélectionné${count > 1 ? 's' : ''}`,\n    range: ({ start, end, total }) => `${start}–${end} sur ${total}`,\n    pagination: 'Pagination du tableau',\n  },\n  toaster: { label: 'Notifications' },\n  snackbar: { label: 'Confirmation', action: 'Annuler' },\n  inputOTP: {\n    label: 'Code de vérification',\n    slot: (index, total) => `Caractère ${index} sur ${total}`,\n  },\n  slider: {\n    value: 'Valeur',\n    start: 'Début',\n    end: 'Fin',\n    rangeStart: (label) => `${label} (début)`,\n    rangeEnd: (label) => `${label} (fin)`,\n  },\n  field: {\n    limitExceeded: (max) => `Dépasse la limite de ${max} caractères`,\n  },\n  // The space before the sign is a NON-BREAKING one, as French typography requires and\n  // English does not. It is written as an escape rather than typed in: the linter refuses\n  // the character itself, and it would be indistinguishable from an ordinary space in a\n  // review.\n  progress: { percent: (percent) => `${percent}\\u00A0%`, label: 'Progression' },\n  hotkeys: {\n    command: 'Commande',\n    ctrl: 'Ctrl',\n    alt: 'Alt',\n    shift: 'Maj',\n    windows: 'Win',\n    super: 'Super',\n    enter: 'Entrée',\n    escape: 'Échap',\n    space: 'Espace',\n    backspace: 'Retour arrière',\n    delete: 'Suppr',\n    tab: 'Tab',\n    up: 'Flèche haut',\n    down: 'Flèche bas',\n    left: 'Flèche gauche',\n    right: 'Flèche droite',\n    label: (keys) => `Raccourci clavier : ${keys}`,\n  },\n  datePicker: {\n    label: 'Sélecteur de date',\n    previousMonth: 'Mois précédent',\n    nextMonth: 'Mois suivant',\n    previousYear: 'Année précédente',\n    nextYear: 'Année suivante',\n    monthPicker: 'Choix du mois',\n    yearPicker: \"Choix de l'année\",\n  },\n  dateInput: {\n    clear: 'Effacer la date',\n    openPicker: 'Ouvrir le calendrier',\n    pickerLabel: 'Choisir une date',\n  },\n  timePicker: {\n    label: \"Sélecteur d'heure\",\n    meridiem: 'AM ou PM',\n    am: 'AM',\n    pm: 'PM',\n    selectHour: 'Sélectionner l’heure',\n    selectMinutes: 'Sélectionner les minutes',\n    choosingHour: 'Sélection de l’heure',\n    choosingMinutes: 'Sélection des minutes',\n    hour: 'Heure',\n    minutes: 'Minutes',\n    hourValue: (hour) => `${hour} heures`,\n    minutesValue: (minute) => `${minute} minutes`,\n  },\n  timeInput: {\n    clear: \"Effacer l'heure\",\n    openPicker: 'Ouvrir le sélecteur d’heure',\n    pickerLabel: 'Choisir une heure',\n    meridiemValue: (value) => `AM ou PM : ${value}`,\n    maskPlaceholder: 'hh:mm',\n    unavailable: \"Cette heure n'est pas disponible.\",\n  },\n  fileInput: {\n    openPicker: 'Choisir des fichiers',\n    clear: 'Effacer les fichiers',\n    // The French plural starts at two, the English one at zero — \"0 fichier\" against\n    // \"0 files\". Each language therefore makes the choice on its own, and there is no\n    // shared rule for either to inherit.\n    files: (count) => `${count} fichier${count > 1 ? 's' : ''}`,\n    placeholder: 'Aucun fichier sélectionné',\n  },\n  filePicker: {\n    browse: 'Parcourir les fichiers',\n    or: 'ou',\n    list: 'Fichiers sélectionnés',\n  },\n  carousel: {\n    label: 'Carrousel',\n    roleDescription: 'carrousel',\n    slideRoleDescription: 'diapositive',\n    slides: 'Diapositives',\n    slide: (index, total) => `${index} sur ${total}`,\n    previous: 'Diapositive précédente',\n    next: 'Diapositive suivante',\n    indicators: 'Choisir la diapositive à afficher',\n  },\n  calendar: {\n    label: 'Calendrier',\n    roleDescription: 'calendrier',\n    today: \"Aujourd'hui\",\n    view: 'Affichage',\n    viewDay: 'Jour',\n    view4Days: '4 jours',\n    viewWeek: 'Semaine',\n    viewMonth: 'Mois',\n    viewYear: 'Année',\n    viewCustom: (days) => `${days} jours`,\n    previousDay: 'Jour précédent',\n    nextDay: 'Jour suivant',\n    previousWeek: 'Semaine précédente',\n    nextWeek: 'Semaine suivante',\n    previousMonth: 'Mois précédent',\n    nextMonth: 'Mois suivant',\n    previousYear: 'Année précédente',\n    nextYear: 'Année suivante',\n    previousPeriod: 'Période précédente',\n    nextPeriod: 'Période suivante',\n    allDay: 'Journée',\n    moreEvents: (count) => `+${count} autre${count > 1 ? 's' : ''}`,\n    openDay: (day) => `Ouvrir le ${day}`,\n    untitled: '(Sans titre)',\n    eventRoleDescription: 'évènement',\n    eventHint:\n      'Appuyez sur Entrée pour ouvrir cet évènement. Appuyez sur Espace pour le saisir, puis sur les flèches pour le déplacer et sur Maj avec les flèches pour changer son heure de fin.',\n    grabbed:\n      'Évènement saisi. Utilisez les flèches pour le déplacer, Entrée ou Espace pour le poser, Échap pour annuler.',\n    dropped: 'Évènement posé.',\n    reverted: \"Déplacement annulé. L'évènement est revenu à sa place.\",\n    movedTo: (title, when) => `${title} déplacé au ${when}.`,\n  },\n}\n"],"mappings":"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"}

package/dist/i18n/state.d.ts

@@ -1,64 +1,61 @@
-import { ShallowRef } from 'vue';
-import { VectisMessages, VectisMessagesInput } from './types.js';
+import { ComputedRef, ShallowRef } from 'vue';
+import { Messages, MessagesInput } from './types.js';
 /** The language tag assumed until one is chosen. */
 export declare const DEFAULT_LOCALE = "en-US";
 /**
- * Chooses the language the design system speaks.
- *
- * Give it a COMPLETE tag — "fr-FR", "en-GB", "de-DE" — rather than a bare language, since
- * it is put to two uses. It picks the dictionary, for which only the language matters;
- * and it is what the calendar and the two pickers hand to the browser, for which the
- * country matters a great deal. A bare "en" is accepted there but means the conventions
- * of no country in particular: hours running to twelve and weeks starting on Sunday,
- * which is not British English. Those three components also take a language of their own,
- * and it wins over this one.
- *
- * Call it from an ordinary module — a plugin, the file that starts the application — and
- * never from inside a component. On a server this choice lives for as long as the process
- * does, which is right for configuration and wrong for anything belonging to one visitor.
- * Setting it only in the browser is its own trap: the page the server built would then be
- * in another language than the one the browser expects, and the two would visibly fail to
- * line up.
+ * Chooses the locale the library speaks.
+ *
+ * Pass a COMPLETE tag — `fr-FR`, `en-GB`, `de-DE` — never a bare language, because it is put
+ * to two uses: it picks the dictionary, where only the subtag matters, and it is what the
+ * calendar and the pickers hand to `Intl`, where the region matters a great deal. A bare
+ * `en` resolves to no region in particular — a 12-hour clock and weeks starting on Sunday,
+ * which is not British English. Those components also take their own `locale`, which wins.
+ *
+ * Call it from a module — a Nuxt plugin, `main.ts` — never inside a `setup()`. On a server
+ * the choice lives as long as the process, which is right for configuration and wrong for
+ * anything belonging to one visitor; setting it client-only makes the server and the client
+ * render different languages, and hydration then visibly fails to line up.
  */
 export declare function setLocale(locale: string): void;
 /**
- * Adds the words of a LANGUAGE, or adjusts the ones already there. What it is filed under
- * is the language alone — "fr", not "fr-FR".
- *
- * This is the one way in, and deliberately so: turning on the French the library ships
- * with and adding a language it does not ship at all are the very SAME gesture.
+ * Adds or adjusts the words of a LANGUAGE, filed under the subtag alone — `fr`, not `fr-FR`.
  *
- * What is given may be a few words rather than a whole dictionary. Anything left out
- * falls back to whatever was registered for that language before, and failing that to the
- * English the library always carries — never to an empty string. Successive calls for one
- * language ADD UP, so registering the French and then correcting a single word keeps the
- * rest of the French.
+ * The one way in, deliberately: enabling the French the library ships and adding a language
+ * it does not ship are the SAME gesture.
  *
- * Passing nothing at all removes what was added, and puts English back as it came.
+ * A partial dictionary is fine. What is left out falls back to whatever was registered
+ * before, then to the English always carried — never to an empty string. Successive calls
+ * for one language ADD UP, so registering `fr` then correcting one word keeps the rest.
+ * Passing `undefined` removes the override and puts English back as it came.
  */
-export declare function registerMessages(lang: string, messages: VectisMessagesInput | undefined): void;
+export declare function registerMessages(lang: string, messages: MessagesInput | undefined): void;
 /**
- * The dictionary in force. Internal to the library — the components read it, and it is
- * not part of the public surface.
+ * The dictionary in force. Internal — components read it, it is not public API.
  *
- * What is handed back is the holder rather than the words inside it, and that is what
- * makes components ALREADY on screen redraw themselves when the language is changed
- * later: reading through the holder is what ties the component to it.
+ * It hands back the `shallowRef` rather than its contents, which is what makes components
+ * ALREADY mounted re-render when `setLocale` is called later.
  *
- * TRAP — reading a word out of it once, at the top of a component, FREEZES that word. It
- * must be read where the reading is repeated: inside something derived, or in the
- * template.
+ * TRAP — reading `.value.x` once in a `setup()` body FREEZES that word. Read it where the
+ * read repeats: inside a `computed`, or in the template.
  *
- * The shape of a composable is deliberate. The day a language per part of the page, or
- * per visitor on a server, becomes necessary, only the BODY of this function changes and
- * no component is touched. It also stays callable outside any component, since all it
- * does is hand back a holder; a version that looked up the tree would have to check for
- * that case.
+ * The composable shape is deliberate. The day a locale per subtree or per request is needed,
+ * only this BODY becomes `inject(messagesKey, null) ?? currentMessages` and no component is
+ * touched. It also stays callable outside a component, since all it does is return a ref;
+ * a version that looked up the tree would need a `getCurrentInstance()` guard.
  */
-export declare function useMessages(): ShallowRef<VectisMessages>;
+export declare function useMessages(): ShallowRef<Messages>;
 /**
- * The language tag in force. Internal to the library: it is what the calendar and the two
- * pickers fall back on when they are given no language of their own, and what the table
- * sorts its rows by.
+ * The locale tag in force. Internal: what the calendar and the pickers fall back on with no
+ * `locale` of their own, and what VDataTable passes to `localeCompare` when it sorts.
  */
 export declare function useLocale(): ShallowRef<string>;
+/**
+ * The locale a component with a `locale` prop of its own actually uses: the prop when it is
+ * given, the locale in force otherwise. Internal, like the two above.
+ *
+ * The prop has no literal default in any of the components that read it, and that is what
+ * this relies on: `undefined` is the "not given" that lets the global locale have its
+ * chance. Every read of the language inside such a component goes through the one computed
+ * returned here, so the two sources are never consulted in a different order somewhere else.
+ */
+export declare function useResolvedLocale(locale: () => string | undefined): ComputedRef<string>;

package/dist/i18n/state.js

@@ -1,40 +1,43 @@
 import { en as e } from "./en.js";
-import { shallowRef as t } from "vue";
+import { computed as t, shallowRef as n } from "vue";
 //#region src/i18n/state.ts
-var n = "en-US", r = "en", i = /* @__PURE__ */ new Map([[r, e]]), a = t(n), o = t(e);
-function s(e) {
+var r = "en-US", i = "en", a = /* @__PURE__ */ new Map([[i, e]]), o = n(r), s = n(e);
+function c(e) {
 	return e.toLowerCase().split("-")[0] ?? e;
 }
-function c(t) {
-	return i.get(s(t)) ?? i.get(r) ?? e;
+function l(t) {
+	return a.get(c(t)) ?? a.get(i) ?? e;
 }
-var l = /* @__PURE__ */ new Set([
+var u = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
 	"prototype"
 ]);
-function u(e, t) {
+function d(e, t) {
 	let n = { ...e };
-	for (let [e, r] of Object.entries(t)) l.has(e) || r && (n[e] = {
+	for (let [e, r] of Object.entries(t)) u.has(e) || r && (n[e] = {
 		...n[e],
 		...r
 	});
 	return n;
 }
-function d(e) {
-	s(e), a.value = e, o.value = c(e);
+function f(e) {
+	c(e), o.value = e, s.value = l(e);
 }
-function f(t, n) {
-	let l = s(t);
-	n === void 0 ? l === r ? i.set(r, e) : i.delete(l) : i.set(l, u(i.get(l) ?? e, n)), o.value = c(a.value);
+function p(t, n) {
+	let r = c(t);
+	n === void 0 ? r === i ? a.set(i, e) : a.delete(r) : a.set(r, d(a.get(r) ?? e, n)), s.value = l(o.value);
 }
-function p() {
+function m() {
+	return s;
+}
+function h() {
 	return o;
 }
-function m() {
-	return a;
+function g(e) {
+	return t(() => e() ?? o.value);
 }
 //#endregion
-export { n as DEFAULT_LOCALE, f as registerMessages, d as setLocale, m as useLocale, p as useMessages };
+export { r as DEFAULT_LOCALE, p as registerMessages, f as setLocale, h as useLocale, m as useMessages, g as useResolvedLocale };
 
 //# sourceMappingURL=state.js.map

package/dist/i18n/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","names":[],"sources":["../../src/i18n/state.ts"],"sourcesContent":["/**\n * The language the design system speaks, and the words it says. No text a reader will\n * ever see is written inside a component: all of it comes from here.\n *\n * The choice of language is held once for the whole application rather than being handed\n * down through the component tree, because it is CONFIGURATION — the same for everyone\n * looking at the site — and because it must remain settable from an ordinary file, a\n * start-up script or a plugin, without a component being involved.\n *\n * ACCEPTED CONSEQUENCE — one language at a time per running server. A site serving an\n * English page and a French one from the same server cannot let those two pages disagree\n * here; it passes the words to the components explicitly instead, along with the language\n * for the calendar and the two pickers. Lifting that limit would change only the body of\n * the last function in this file, and no component at all.\n */\nimport { shallowRef, type ShallowRef } from 'vue'\n\nimport { isDev } from '../utils/env'\n\nimport { en } from './en'\nimport type { VectisMessages, VectisMessagesInput } from './types'\n\n/** The language tag assumed until one is chosen. */\nexport const DEFAULT_LOCALE = 'en-US'\nconst DEFAULT_LANG = 'en'\n\n/**\n * The dictionaries, filed under the LANGUAGE alone — \"en\", \"fr\", \"de\" — and not under the\n * country as well. British, American and Australian English share every word. What does\n * separate them, the order of the parts of a date, the day a week starts on, whether the\n * hours run to twelve or twenty-four, is worked out by the browser from the complete tag\n * and is never a matter of translation.\n *\n * The collection itself is deliberately inert: what components watch is the current\n * dictionary below, which is recalculated whenever the collection changes.\n */\nconst registry = new Map<string, VectisMessages>([[DEFAULT_LANG, en]])\n\nconst currentLocale = shallowRef<string>(DEFAULT_LOCALE)\nconst currentMessages = shallowRef<VectisMessages>(en)\n\n/**\n * The language part of a tag: British English is filed under English. A tag that makes no\n * sense comes back untouched, and will simply match no dictionary.\n */\nfunction langOf(locale: string): string {\n  return locale.toLowerCase().split('-')[0] ?? locale\n}\n\n/**\n * The dictionary a tag resolves to, falling back to the default language.\n *\n * The last `?? en` never fires: `registry` is seeded with `DEFAULT_LANG` and the only path\n * that could remove it — `registerMessages` passing `undefined` — puts `en` straight back\n * instead of deleting. It stays because `Map.get` is typed `T | undefined`, so the compiler\n * demands an exhaustive expression; the alternative is a non-null assertion, which would\n * hide the reasoning rather than record it. Do not read it as a live third case.\n */\nfunction resolve(locale: string): VectisMessages {\n  return registry.get(langOf(locale)) ?? registry.get(DEFAULT_LANG) ?? en\n}\n\n/** Names that would reach into an object's own machinery instead of naming a section. */\nconst FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype'])\n\n/**\n * Lays a handful of replacement words over a complete dictionary.\n *\n * It descends exactly TWO levels and no further, which the shape of a dictionary\n * guarantees is enough: below a section there are only finished values, a piece of text or\n * a function that builds one. Nothing is walked recursively, so a FUNCTION can never be\n * mistaken for an object and taken apart — which would leave an empty one behind, and a\n * message that renders as nothing.\n */\nfunction mergeMessages(base: VectisMessages, patch: VectisMessagesInput): VectisMessages {\n  const out: Record<string, object> = { ...base }\n  for (const [namespace, section] of Object.entries(patch)) {\n    // A dictionary that came out of a parsed file can carry one of those names as a\n    // section of its own, and assigning to it would replace the merged dictionary's\n    // machinery rather than adding a section. Nothing outside is affected — the object\n    // being built is a fresh copy — but the result is a dictionary in which every single\n    // lookup is wrong, and nothing says so.\n    if (FORBIDDEN_KEYS.has(namespace)) continue\n    if (section) out[namespace] = { ...out[namespace], ...section }\n  }\n  return out as unknown as VectisMessages\n}\n\n/**\n * Chooses the language the design system speaks.\n *\n * Give it a COMPLETE tag — \"fr-FR\", \"en-GB\", \"de-DE\" — rather than a bare language, since\n * it is put to two uses. It picks the dictionary, for which only the language matters;\n * and it is what the calendar and the two pickers hand to the browser, for which the\n * country matters a great deal. A bare \"en\" is accepted there but means the conventions\n * of no country in particular: hours running to twelve and weeks starting on Sunday,\n * which is not British English. Those three components also take a language of their own,\n * and it wins over this one.\n *\n * Call it from an ordinary module — a plugin, the file that starts the application — and\n * never from inside a component. On a server this choice lives for as long as the process\n * does, which is right for configuration and wrong for anything belonging to one visitor.\n * Setting it only in the browser is its own trap: the page the server built would then be\n * in another language than the one the browser expects, and the two would visibly fail to\n * line up.\n */\nexport function setLocale(locale: string): void {\n  const lang = langOf(locale)\n  if (isDev && !registry.has(lang)) {\n    console.warn(\n      `[vectis] No dictionary registered for “${lang}”: the text stays in ` +\n        `“${DEFAULT_LANG}”. French is shipped — import { fr } from 'vectis-ui' then ` +\n        `registerMessages('fr', fr). For another language: registerMessages('${lang}', { … }).`,\n    )\n  }\n  currentLocale.value = locale\n  currentMessages.value = resolve(locale)\n}\n\n/**\n * Adds the words of a LANGUAGE, or adjusts the ones already there. What it is filed under\n * is the language alone — \"fr\", not \"fr-FR\".\n *\n * This is the one way in, and deliberately so: turning on the French the library ships\n * with and adding a language it does not ship at all are the very SAME gesture.\n *\n * What is given may be a few words rather than a whole dictionary. Anything left out\n * falls back to whatever was registered for that language before, and failing that to the\n * English the library always carries — never to an empty string. Successive calls for one\n * language ADD UP, so registering the French and then correcting a single word keeps the\n * rest of the French.\n *\n * Passing nothing at all removes what was added, and puts English back as it came.\n */\nexport function registerMessages(lang: string, messages: VectisMessagesInput | undefined): void {\n  const key = langOf(lang)\n  if (isDev && key !== lang.toLowerCase()) {\n    console.warn(\n      `[vectis] registerMessages('${lang}', …): the expected key is a language subtag ` +\n        `alone — registered under “${key}”, which covers all its regional variants.`,\n    )\n  }\n  if (messages === undefined) {\n    if (key === DEFAULT_LANG) registry.set(DEFAULT_LANG, en)\n    else registry.delete(key)\n  } else {\n    registry.set(key, mergeMessages(registry.get(key) ?? en, messages))\n  }\n  currentMessages.value = resolve(currentLocale.value)\n}\n\n/**\n * The dictionary in force. Internal to the library — the components read it, and it is\n * not part of the public surface.\n *\n * What is handed back is the holder rather than the words inside it, and that is what\n * makes components ALREADY on screen redraw themselves when the language is changed\n * later: reading through the holder is what ties the component to it.\n *\n * TRAP — reading a word out of it once, at the top of a component, FREEZES that word. It\n * must be read where the reading is repeated: inside something derived, or in the\n * template.\n *\n * The shape of a composable is deliberate. The day a language per part of the page, or\n * per visitor on a server, becomes necessary, only the BODY of this function changes and\n * no component is touched. It also stays callable outside any component, since all it\n * does is hand back a holder; a version that looked up the tree would have to check for\n * that case.\n */\nexport function useMessages(): ShallowRef<VectisMessages> {\n  return currentMessages\n}\n\n/**\n * The language tag in force. Internal to the library: it is what the calendar and the two\n * pickers fall back on when they are given no language of their own, and what the table\n * sorts its rows by.\n */\nexport function useLocale(): ShallowRef<string> {\n  return currentLocale\n}\n"],"mappings":";;;AAuBA,IAAa,IAAiB,SACxB,IAAe,MAYf,oBAAW,IAAI,IAA4B,CAAC,CAAC,GAAc,CAAE,CAAC,CAAC,GAE/D,IAAgB,EAAmB,CAAc,GACjD,IAAkB,EAA2B,CAAE;AAMrD,SAAS,EAAO,GAAwB;CACtC,OAAO,EAAO,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM;AAC/C;AAWA,SAAS,EAAQ,GAAgC;CAC/C,OAAO,EAAS,IAAI,EAAO,CAAM,CAAC,KAAK,EAAS,IAAI,CAAY,KAAK;AACvE;AAGA,IAAM,oBAAiB,IAAI,IAAI;CAAC;CAAa;CAAe;AAAW,CAAC;AAWxE,SAAS,EAAc,GAAsB,GAA4C;CACvF,IAAM,IAA8B,EAAE,GAAG,EAAK;CAC9C,KAAK,IAAM,CAAC,GAAW,MAAY,OAAO,QAAQ,CAAK,GAMjD,EAAe,IAAI,CAAS,KAC5B,MAAS,EAAI,KAAa;EAAE,GAAG,EAAI;EAAY,GAAG;CAAQ;CAEhE,OAAO;AACT;AAoBA,SAAgB,EAAU,GAAsB;CAU9C,AATa,EAAO,CAAM,GAQ1B,EAAc,QAAQ,GACtB,EAAgB,QAAQ,EAAQ,CAAM;AACxC;AAiBA,SAAgB,EAAiB,GAAc,GAAiD;CAC9F,IAAM,IAAM,EAAO,CAAI;CAavB,AANI,MAAa,KAAA,IACX,MAAQ,IAAc,EAAS,IAAI,GAAc,CAAE,IAClD,EAAS,OAAO,CAAG,IAExB,EAAS,IAAI,GAAK,EAAc,EAAS,IAAI,CAAG,KAAK,GAAI,CAAQ,CAAC,GAEpE,EAAgB,QAAQ,EAAQ,EAAc,KAAK;AACrD;AAoBA,SAAgB,IAA0C;CACxD,OAAO;AACT;AAOA,SAAgB,IAAgC;CAC9C,OAAO;AACT"}
+{"version":3,"file":"state.js","names":[],"sources":["../../src/i18n/state.ts"],"sourcesContent":["/**\n * The locale the library speaks and the words it says. No user-facing text is written in a\n * component; all of it comes from here.\n *\n * Module-level state rather than provide/inject, because this is CONFIGURATION: the same\n * for every visitor, and settable from any `.ts` — a plugin, an entry file — with no\n * component involved.\n *\n * ACCEPTED LIMIT — one locale per process. A single Node process serving /en and /fr cannot\n * let the two disagree here; it passes the text props explicitly instead. Lifting the limit\n * would change only the body of `useMessages` below, and no component at all.\n */\nimport { computed, shallowRef, type ComputedRef, type ShallowRef } from 'vue'\n\nimport { isDev } from '../utils/env'\n\nimport { en } from './en'\nimport type { Messages, MessagesInput } from './types'\n\n/** The language tag assumed until one is chosen. */\nexport const DEFAULT_LOCALE = 'en-US'\nconst DEFAULT_LANG = 'en'\n\n/**\n * The dictionaries, filed under the LANGUAGE subtag alone — `en`, `fr`, `de`. `en-GB` and\n * `en-US` share every word; what separates them (field order, first day of week, hour cycle)\n * comes from `Intl` on the full tag and is never a matter of translation.\n *\n * The Map is deliberately inert: what components track is `currentMessages` below, which is\n * recomputed whenever it changes.\n */\nconst registry = new Map<string, Messages>([[DEFAULT_LANG, en]])\n\nconst currentLocale = shallowRef<string>(DEFAULT_LOCALE)\nconst currentMessages = shallowRef<Messages>(en)\n\n/**\n * The language part of a tag: British English is filed under English. A tag that makes no\n * sense comes back untouched, and will simply match no dictionary.\n */\nfunction langOf(locale: string): string {\n  return locale.toLowerCase().split('-')[0] ?? locale\n}\n\n/**\n * The dictionary a tag resolves to, falling back to the default language.\n *\n * The last `?? en` never fires: `registry` is seeded with `DEFAULT_LANG` and the only path\n * that could remove it — `registerMessages` passing `undefined` — puts `en` straight back\n * instead of deleting. It stays because `Map.get` is typed `T | undefined`, so the compiler\n * demands an exhaustive expression; the alternative is a non-null assertion, which would\n * hide the reasoning rather than record it. Do not read it as a live third case.\n */\nfunction resolve(locale: string): Messages {\n  return registry.get(langOf(locale)) ?? registry.get(DEFAULT_LANG) ?? en\n}\n\n/** Names that would reach into an object's own machinery instead of naming a section. */\nconst FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype'])\n\n/**\n * Lays a partial override over a complete dictionary.\n *\n * Depth EXACTLY 2, which the dictionary's shape guarantees is enough: below a namespace\n * there are only leaves, a string or a function returning one. Nothing recurses, so a\n * FUNCTION can never be mistaken for an object and taken apart — which would leave `{}`\n * behind and a message that renders as nothing.\n */\nfunction mergeMessages(base: Messages, patch: MessagesInput): Messages {\n  const out: Record<string, object> = { ...base }\n  for (const [namespace, section] of Object.entries(patch)) {\n    // A dictionary parsed from a file can carry one of these as a namespace, and assigning\n    // to it would replace the copy's own machinery instead of adding a section. Nothing\n    // outside is affected, the object being fresh — but every lookup in it is then wrong,\n    // and nothing says so.\n    if (FORBIDDEN_KEYS.has(namespace)) continue\n    if (section) out[namespace] = { ...out[namespace], ...section }\n  }\n  return out as unknown as Messages\n}\n\n/**\n * Chooses the locale the library speaks.\n *\n * Pass a COMPLETE tag — `fr-FR`, `en-GB`, `de-DE` — never a bare language, because it is put\n * to two uses: it picks the dictionary, where only the subtag matters, and it is what the\n * calendar and the pickers hand to `Intl`, where the region matters a great deal. A bare\n * `en` resolves to no region in particular — a 12-hour clock and weeks starting on Sunday,\n * which is not British English. Those components also take their own `locale`, which wins.\n *\n * Call it from a module — a Nuxt plugin, `main.ts` — never inside a `setup()`. On a server\n * the choice lives as long as the process, which is right for configuration and wrong for\n * anything belonging to one visitor; setting it client-only makes the server and the client\n * render different languages, and hydration then visibly fails to line up.\n */\nexport function setLocale(locale: string): void {\n  const lang = langOf(locale)\n  if (isDev && !registry.has(lang)) {\n    console.warn(\n      `[vectis] No dictionary registered for “${lang}”: the text stays in ` +\n        `“${DEFAULT_LANG}”. French is shipped — import { fr } from 'vectis-ui' then ` +\n        `registerMessages('fr', fr). For another language: registerMessages('${lang}', { … }).`,\n    )\n  }\n  currentLocale.value = locale\n  currentMessages.value = resolve(locale)\n}\n\n/**\n * Adds or adjusts the words of a LANGUAGE, filed under the subtag alone — `fr`, not `fr-FR`.\n *\n * The one way in, deliberately: enabling the French the library ships and adding a language\n * it does not ship are the SAME gesture.\n *\n * A partial dictionary is fine. What is left out falls back to whatever was registered\n * before, then to the English always carried — never to an empty string. Successive calls\n * for one language ADD UP, so registering `fr` then correcting one word keeps the rest.\n * Passing `undefined` removes the override and puts English back as it came.\n */\nexport function registerMessages(lang: string, messages: MessagesInput | undefined): void {\n  const key = langOf(lang)\n  if (isDev && key !== lang.toLowerCase()) {\n    console.warn(\n      `[vectis] registerMessages('${lang}', …): the expected key is a language subtag ` +\n        `alone — registered under “${key}”, which covers all its regional variants.`,\n    )\n  }\n  if (messages === undefined) {\n    if (key === DEFAULT_LANG) registry.set(DEFAULT_LANG, en)\n    else registry.delete(key)\n  } else {\n    registry.set(key, mergeMessages(registry.get(key) ?? en, messages))\n  }\n  currentMessages.value = resolve(currentLocale.value)\n}\n\n/**\n * The dictionary in force. Internal — components read it, it is not public API.\n *\n * It hands back the `shallowRef` rather than its contents, which is what makes components\n * ALREADY mounted re-render when `setLocale` is called later.\n *\n * TRAP — reading `.value.x` once in a `setup()` body FREEZES that word. Read it where the\n * read repeats: inside a `computed`, or in the template.\n *\n * The composable shape is deliberate. The day a locale per subtree or per request is needed,\n * only this BODY becomes `inject(messagesKey, null) ?? currentMessages` and no component is\n * touched. It also stays callable outside a component, since all it does is return a ref;\n * a version that looked up the tree would need a `getCurrentInstance()` guard.\n */\nexport function useMessages(): ShallowRef<Messages> {\n  return currentMessages\n}\n\n/**\n * The locale tag in force. Internal: what the calendar and the pickers fall back on with no\n * `locale` of their own, and what VDataTable passes to `localeCompare` when it sorts.\n */\nexport function useLocale(): ShallowRef<string> {\n  return currentLocale\n}\n\n/**\n * The locale a component with a `locale` prop of its own actually uses: the prop when it is\n * given, the locale in force otherwise. Internal, like the two above.\n *\n * The prop has no literal default in any of the components that read it, and that is what\n * this relies on: `undefined` is the \"not given\" that lets the global locale have its\n * chance. Every read of the language inside such a component goes through the one computed\n * returned here, so the two sources are never consulted in a different order somewhere else.\n */\nexport function useResolvedLocale(locale: () => string | undefined): ComputedRef<string> {\n  return computed(() => locale() ?? currentLocale.value)\n}\n"],"mappings":";;;AAoBA,IAAa,IAAiB,SACxB,IAAe,MAUf,oBAAW,IAAI,IAAsB,CAAC,CAAC,GAAc,CAAE,CAAC,CAAC,GAEzD,IAAgB,EAAmB,CAAc,GACjD,IAAkB,EAAqB,CAAE;AAM/C,SAAS,EAAO,GAAwB;CACtC,OAAO,EAAO,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM;AAC/C;AAWA,SAAS,EAAQ,GAA0B;CACzC,OAAO,EAAS,IAAI,EAAO,CAAM,CAAC,KAAK,EAAS,IAAI,CAAY,KAAK;AACvE;AAGA,IAAM,oBAAiB,IAAI,IAAI;CAAC;CAAa;CAAe;AAAW,CAAC;AAUxE,SAAS,EAAc,GAAgB,GAAgC;CACrE,IAAM,IAA8B,EAAE,GAAG,EAAK;CAC9C,KAAK,IAAM,CAAC,GAAW,MAAY,OAAO,QAAQ,CAAK,GAKjD,EAAe,IAAI,CAAS,KAC5B,MAAS,EAAI,KAAa;EAAE,GAAG,EAAI;EAAY,GAAG;CAAQ;CAEhE,OAAO;AACT;AAgBA,SAAgB,EAAU,GAAsB;CAU9C,AATa,EAAO,CAAM,GAQ1B,EAAc,QAAQ,GACtB,EAAgB,QAAQ,EAAQ,CAAM;AACxC;AAaA,SAAgB,EAAiB,GAAc,GAA2C;CACxF,IAAM,IAAM,EAAO,CAAI;CAavB,AANI,MAAa,KAAA,IACX,MAAQ,IAAc,EAAS,IAAI,GAAc,CAAE,IAClD,EAAS,OAAO,CAAG,IAExB,EAAS,IAAI,GAAK,EAAc,EAAS,IAAI,CAAG,KAAK,GAAI,CAAQ,CAAC,GAEpE,EAAgB,QAAQ,EAAQ,EAAc,KAAK;AACrD;AAgBA,SAAgB,IAAoC;CAClD,OAAO;AACT;AAMA,SAAgB,IAAgC;CAC9C,OAAO;AACT;AAWA,SAAgB,EAAkB,GAAuD;CACvF,OAAO,QAAe,EAAO,KAAK,EAAc,KAAK;AACvD"}

package/dist/i18n/types.d.ts

@@ -1,27 +1,23 @@
 /**
- * Every word the design system can say to a reader, gathered in one place. This is what a
- * translator works from, and what a consumer overrides to change a turn of phrase.
+ * Every user-facing word the library can say, in one place: what a translator works from and
+ * what a consumer overrides.
  *
- * It is arranged in exactly TWO levels: a section, then an entry. An entry is finished
- * text, or — when something has to be slotted into it — a small function that builds the
- * sentence.
+ * Depth EXACTLY 2 — namespace, then leaf. A leaf is finished text, or a TS function when
+ * something has to be slotted in. There is deliberately no template language and no plural
+ * engine: a parameterized message IS a hand-written function whose signature is the
+ * contract, so a translation that forgets an argument does not compile, and a plural is a
+ * ternary inside it.
  *
- * There is deliberately no template language and no rules engine for plurals. A message
- * that takes a value IS a function, written by hand, and its arguments are the contract: a
- * translation that forgets one does not compile. A plural is a choice between two forms
- * written inside that function.
+ * The two levels are structural, not aesthetic: they are what lets a partial override be
+ * merged NON-RECURSIVELY, and therefore what makes it impossible to descend into one of
+ * those functions and turn it into `{}`.
  *
- * Two levels is not an aesthetic choice. It is what allows a handful of replacement words
- * to be laid over a dictionary without descending into it, and therefore what makes it
- * impossible to mistake one of those functions for something to be taken apart.
- *
- * Three kinds of text are deliberately absent. Anything the browser already knows how to
- * say in any language: the names of months and days, the order of the parts of a date,
- * whether hours run to twelve or twenty-four. Anything made only of digits and
- * punctuation everyone shares — "99+", "+3", a "3/8" counter, the colon in a time.
- * And the warnings the library prints for the developer, which are not translated at all.
+ * Three kinds of text are deliberately absent. Whatever `Intl` derives from the tag (month
+ * and day names, field order, hour cycle); whatever is made only of digits and universal
+ * punctuation (`99+`, `+N`, an `N/M` counter, a time's colon); and the `[Component] …`
+ * warnings, which address the integrator and are never translated.
  */
-export interface VectisMessages {
+export interface Messages {
     /** Words several components share, so that they are translated once rather than five times. */
     common: {
         /** Said by the spinner, and by the fields and the search box while they are loading. */
@@ -32,6 +28,11 @@ export interface VectisMessages {
         close: string;
         /** The cross that removes a chip. */
         dismiss: string;
+        /**
+         * The same cross when it has to say WHICH thing it removes: a value of a combobox, a
+         * file of either file component. The name is the thing's own label.
+         */
+        remove: (name: string) => string;
         /** The two buttons under the clock face. */
         cancel: string;
         confirm: string;
@@ -41,8 +42,6 @@ export interface VectisMessages {
         previous: string;
         next: string;
         page: (page: number) => string;
-        /** The ellipsis standing in for the pages that are not shown. It is decorative, and never spoken. */
-        hiddenPages: string;
     };
     tabs: {
         label: string;
@@ -64,7 +63,6 @@ export interface VectisMessages {
     combobox: {
         empty: string;
         clear: string;
-        remove: (label: string) => string;
     };
     dataTable: {
         empty: string;
@@ -169,6 +167,8 @@ export interface VectisMessages {
         label: (keys: string) => string;
     };
     datePicker: {
+        /** What the whole picker is called, header and grid together. */
+        label: string;
         previousMonth: string;
         nextMonth: string;
         previousYear: string;
@@ -178,47 +178,61 @@ export interface VectisMessages {
     };
     dateInput: {
         clear: string;
-        open: string;
-        label: string;
+        /** What the button at the end of the field is called: the one that opens the calendar. */
+        openPicker: string;
+        /** What the panel holding the calendar is called. */
+        pickerLabel: string;
     };
     /** The clock itself. VTimeInput reads the half-day words from here too: there is one
         vocabulary for choosing a time, wherever the control that does it is rendered. */
     timePicker: {
+        /** What the whole clock is called, the numerals and the face together. */
+        label: string;
         meridiem: string;
         am: string;
         pm: string;
         selectHour: string;
-        selectMinute: string;
-        /** Announced when the clock face moves from choosing an hour to choosing a minute. */
-        hourStep: string;
-        minuteStep: string;
+        selectMinutes: string;
+        /** Announced when the clock face moves between choosing the hour and the minutes. */
+        choosingHour: string;
+        choosingMinutes: string;
         /** What the clock face itself is called, which changes with the step. */
         hour: string;
         minutes: string;
         /** What the clock face announces as its value, rather than the bare number behind it. */
-        hoursValue: (hour: number) => string;
+        hourValue: (hour: number) => string;
         minutesValue: (minute: number) => string;
     };
     timeInput: {
         clear: string;
-        openList: string;
+        /** What the button at the end of the field is called: the one that opens the clock. */
         openPicker: string;
-        listLabel: string;
         /** What the panel holding the clock is called. */
         pickerLabel: string;
+        /**
+         * What the AM/PM button inside the field is called, the half of the day it currently
+         * shows included. The value is what the button reads on screen, so the name repeats
+         * it rather than replacing it: a reader arriving on the button is told which half is
+         * chosen, and hears the new one as soon as it changes.
+         */
+        meridiemValue: (value: string) => string;
         /**
          * The grey template shown in an empty field, "hh:mm". It is translatable because those
          * letters are the initials of WORDS — unlike the colon between them, which is the same
          * everywhere and lives with the time helpers.
          */
         maskPlaceholder: string;
+        /**
+         * What the field says of a time the restrictions do not allow. It is carried by the
+         * control's own validity rather than displayed, so a browser is what shows it, and in
+         * the language the browser is being told to speak here.
+         */
+        unavailable: string;
     };
     fileInput: {
-        /** What the button at the end of the field is called — the one that opens the file dialog. */
-        attach: string;
+        /** What the button at the end of the field is called: the one that opens the file dialog. */
+        openPicker: string;
         clear: string;
-        /** What the cross on a file's chip is called. */
-        remove: (name: string) => string;
         /**
          * The WORD of the counter, and only that. The total size that follows is written out
          * by the browser, and the brackets around it belong to neither — punctuation everyone
@@ -236,8 +250,6 @@ export interface VectisMessages {
          * it is translated — unlike the two rules on either side of it, which are drawn.
          */
         or: string;
-        /** What the cross beside a chosen file is called. */
-        remove: (name: string) => string;
         /** What the list of chosen files is called. */
         list: string;
     };
@@ -314,11 +326,8 @@ export interface VectisMessages {
         moreEvents: (count: number) => string;
         /** How a day in the month and year views offers to be opened on its own. */
         openDay: (day: string) => string;
-        /**
-         * The name a newly created event is given. The number is the one a reader counts,
-         * starting at one — it carries no unit, so a language that writes it differently can.
-         */
-        newEvent: (index: number) => string;
+        /** What the card of a slot being drawn out is called, before it is anything else. */
+        untitled: string;
         /** What one event IS, said in place of the word "button". */
         eventRoleDescription: string;
         /** How a card says it can be moved. It is read once, from a single shared node. */
@@ -340,6 +349,6 @@ export interface VectisMessages {
  * takes a value stays a whole function. Making it recursive would allow one of those
  * functions to be described as a partial object, which is to say as nothing at all.
  */
-export type VectisMessagesInput = {
-    [K in keyof VectisMessages]?: Partial<VectisMessages[K]>;
+export type MessagesInput = {
+    [K in keyof Messages]?: Partial<Messages[K]>;
 };

package/dist/icons.d.ts

@@ -4,9 +4,9 @@
  *
  * Reach for it when you want to render one of the library's own icons somewhere it
  * does not already appear: `import { search } from 'vectis-ui/icons'`, then
- * `<VIcon :name="search" />`. A bare `<VIcon name="search" />` no longer finds it,
- * and that is the point — an icon is shipped to a consumer's bundle because a module
- * imported it, never because a string might one day ask for it.
+ * `<VIcon :name="search" />`. A bare `<VIcon name="search" />` is a NAME and does
+ * not reach it, which is the point — an icon is shipped to a consumer's bundle because
+ * a module imported it, never because a string might one day ask for it.
  *
  * Each value carries its NAME as well as its drawing, so it still passes through a
  * resolver installed with `setIconResolver`: wiring your own icon library keeps