@eifi1/ui-kit 0.36.0 → 0.38.0

package/src/i18n/locales/fr.ts

@@ -55,6 +55,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       submitHint: (apple) => (apple ? "⌘ Entrée pour envoyer" : "Ctrl+Entrée pour envoyer"),
       cancel: "Annuler",
       save: "Envoyer",
+      publicNotice: "Les autres personnes verront le titre et le texte (jamais vos captures d’écran ni vos fichiers).",
     },
     feedbackThread: {
       thread: "Commentaires",
@@ -106,6 +107,36 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       trigger: "Envoyer un retour",
       myFeedback: "Mes retours",
       viewFeedback: "Voir les retours",
+      allFeedback: "Tous les retours",
+    },
+    // 0.38.0 — docs/feedback-harmonization.md §9: the public pages and the two feedback
+    // notification types. "Retour" for a report, as `feedbackMenu`.
+    feedbackPublic: {
+      title: "Tous les retours",
+      sort: "Trier",
+      sortNewest: "Plus récents",
+      sortVotes: "Plus demandés",
+      sortUpdated: "Mis à jour récemment",
+      search: "Rechercher dans les titres",
+      columnVotes: "Votes",
+      total: (count) => (count === 1 ? "1 retour" : `${n(count)} retours`),
+      comments: (count) => (count === 1 ? "1 commentaire" : `${n(count)} commentaires`),
+      votes: (count) => (count === 1 ? "1 vote" : `${n(count)} votes`),
+      anonymous: "Une personne",
+      filedBy: (name) => `De ${name}`,
+      body: "Description",
+      conversation: "Réponses et commentaires",
+      loading: "Chargement…",
+      empty: "Aucun retour pour l’instant",
+      visibleToOthers: "Visible par les autres",
+      visibleHint: "Les autres personnes voient le titre et le texte, jamais vos captures d’écran ni vos fichiers.",
+      visibleLocked: "Seulement tant que le retour est encore ouvert.",
+    },
+    feedbackNotificationTypes: {
+      answered: "Réponses à vos retours",
+      answeredDescription: "Quand un retour que vous avez écrit ou commenté reçoit une réponse.",
+      comment: "Commentaires sur les retours que vous suivez",
+      commentDescription: "Quand quelqu’un commente un retour que vous avez écrit ou commenté.",
     },
     feedbackContext: {
       user: "Utilisateur",
@@ -146,6 +177,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       download: (name) => `Télécharger ${name}`,
       downloadFailed: "La pièce jointe n’a pas pu être téléchargée.",
       outcome: "Résultat",
+      replies: "Réponses",
       resolvedAt: (date) => `Résolu le ${date}`,
       outcomeAdd: "Ajouter un résultat",
       outcomeUpdate: "Mettre à jour",
@@ -160,6 +192,36 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       status: "Statut",
       note: "Note",
     },
+    // 0.38.0 — docs/feedback-harmonization.md §9.15: the vote, the comment thread, the replies.
+    feedbackVote: {
+      vote: "Moi aussi",
+      own: "Votre retour",
+    },
+    feedbackComments: {
+      comments: "Commentaires",
+      empty: "Pas encore de commentaire",
+      hidden: "Masqué par un administrateur",
+      hide: "Masquer",
+      unhide: "Afficher",
+      delete: "Supprimer",
+      deleteTitle: "Supprimer ce commentaire\u202f?",
+      deleteBody: "Il sera retiré pour tout le monde. Cette action est irréversible.",
+      field: "Écrire un commentaire",
+      placeholder: "Écrire un commentaire…",
+      send: "Commenter",
+    },
+    feedbackReplies: {
+      replies: "Réponses",
+      empty: "Pas encore de réponse",
+      admin: "Admin",
+      statusChanged: "Statut changé en",
+      field: "Écrire une réponse",
+      placeholder: "Écrire une réponse…",
+      reply: "Répondre",
+      status: "Statut avec la réponse",
+      noChange: "Aucun changement",
+      nudge: "La personne qui l’a signalé n’a pas été prévenue. Ajoutez une réponse.",
+    },
     accountSettings: {
       profile: {
         title: "Profil",

package/src/i18n/locales/hu.ts

@@ -54,6 +54,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       submitHint: (apple) => (apple ? "⌘ Enter a küldéshez" : "Ctrl+Enter a küldéshez"),
       cancel: "Mégse",
       save: "Küldés",
+      publicNotice: "Mások látni fogják a címet és a szöveget (a képernyőképeit és fájljait soha).",
     },
     feedbackThread: {
       thread: "Hozzászólások",
@@ -105,6 +106,36 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       trigger: "Visszajelzés küldése",
       myFeedback: "Visszajelzéseim",
       viewFeedback: "Visszajelzések megtekintése",
+      allFeedback: "Összes visszajelzés",
+    },
+    // 0.38.0 — docs/feedback-harmonization.md §9: the public pages and the two feedback
+    // notification types. A noun after a number stays singular in Hungarian.
+    feedbackPublic: {
+      title: "Összes visszajelzés",
+      sort: "Rendezés",
+      sortNewest: "Legújabb",
+      sortVotes: "Legkeresettebb",
+      sortUpdated: "Nemrég frissítve",
+      search: "Keresés a címekben",
+      columnVotes: "Szavazatok",
+      total: (count) => `${n(count)} bejelentés`,
+      comments: (count) => `${n(count)} hozzászólás`,
+      votes: (count) => `${n(count)} szavazat`,
+      anonymous: "Egy felhasználó",
+      filedBy: (name) => `Beküldte: ${name}`,
+      body: "Leírás",
+      conversation: "Válaszok és hozzászólások",
+      loading: "Betöltés…",
+      empty: "Még nincs bejelentés",
+      visibleToOthers: "Mások számára látható",
+      visibleHint: "Mások a címet és a szöveget látják, a képernyőképeit és fájljait soha.",
+      visibleLocked: "Csak amíg a bejelentés nyitott.",
+    },
+    feedbackNotificationTypes: {
+      answered: "Válaszok a bejelentéseire",
+      answeredDescription: "Amikor egy Ön által írt vagy hozzászólt bejelentés választ kap.",
+      comment: "Hozzászólások a követett bejelentésekhez",
+      commentDescription: "Amikor valaki hozzászól egy Ön által írt vagy hozzászólt bejelentéshez.",
     },
     feedbackContext: {
       user: "Felhasználó",
@@ -145,6 +176,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       download: (name) => `${name} letöltése`,
       downloadFailed: "A mellékletet nem sikerült letölteni.",
       outcome: "Eredmény",
+      replies: "Válaszok",
       resolvedAt: (date) => `Lezárva: ${date}`,
       outcomeAdd: "Eredmény hozzáadása",
       outcomeUpdate: "Frissítés",
@@ -158,6 +190,36 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       status: "Állapot",
       note: "Megjegyzés",
     },
+    // 0.38.0 — docs/feedback-harmonization.md §9.15: the vote, the comment thread, the replies.
+    feedbackVote: {
+      vote: "Én is szeretném",
+      own: "Az Ön bejelentése",
+    },
+    feedbackComments: {
+      comments: "Hozzászólások",
+      empty: "Még nincs hozzászólás",
+      hidden: "Egy admin elrejtette",
+      hide: "Elrejtés",
+      unhide: "Megjelenítés",
+      delete: "Törlés",
+      deleteTitle: "Törli ezt a hozzászólást?",
+      deleteBody: "Mindenki számára eltűnik. Ez nem vonható vissza.",
+      field: "Hozzászólás írása",
+      placeholder: "Hozzászólás írása…",
+      send: "Hozzászólás",
+    },
+    feedbackReplies: {
+      replies: "Válaszok",
+      empty: "Még nincs válasz",
+      admin: "Admin",
+      statusChanged: "Állapot módosítva erre:",
+      field: "Válasz írása",
+      placeholder: "Válasz írása…",
+      reply: "Válasz",
+      status: "Állapot a válasszal",
+      noChange: "Nincs változás",
+      nudge: "A bejelentő nem kapott értesítést. Írjon választ.",
+    },
     accountSettings: {
       profile: {
         title: "Profil",

package/src/i18n/locales/it.ts

@@ -55,6 +55,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       submitHint: (apple) => (apple ? "⌘ Invio per inviare" : "Ctrl+Invio per inviare"),
       cancel: "Annulla",
       save: "Invia",
+      publicNotice: "Le altre persone vedranno il titolo e il testo (mai i Suoi screenshot o file).",
     },
     feedbackThread: {
       thread: "Commenti",
@@ -108,6 +109,36 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       trigger: "Invia feedback",
       myFeedback: "I miei feedback",
       viewFeedback: "Visualizza feedback",
+      allFeedback: "Tutti i feedback",
+    },
+    // 0.38.0 — docs/feedback-harmonization.md §9: the public pages and the two feedback
+    // notification types. "Segnalazione" for one report; formal "Lei", as elsewhere.
+    feedbackPublic: {
+      title: "Tutti i feedback",
+      sort: "Ordina",
+      sortNewest: "Più recenti",
+      sortVotes: "Più richiesti",
+      sortUpdated: "Aggiornati di recente",
+      search: "Cerca nei titoli",
+      columnVotes: "Voti",
+      total: (count) => (count === 1 ? "1 segnalazione" : `${n(count)} segnalazioni`),
+      comments: (count) => (count === 1 ? "1 commento" : `${n(count)} commenti`),
+      votes: (count) => (count === 1 ? "1 voto" : `${n(count)} voti`),
+      anonymous: "Una persona",
+      filedBy: (name) => `Da ${name}`,
+      body: "Descrizione",
+      conversation: "Risposte e commenti",
+      loading: "Caricamento…",
+      empty: "Ancora nessuna segnalazione",
+      visibleToOthers: "Visibile agli altri",
+      visibleHint: "Le altre persone vedono il titolo e il testo, mai i Suoi screenshot o file.",
+      visibleLocked: "Solo finché la segnalazione è ancora aperta.",
+    },
+    feedbackNotificationTypes: {
+      answered: "Risposte alle Sue segnalazioni",
+      answeredDescription: "Quando una segnalazione che ha scritto o commentato riceve una risposta.",
+      comment: "Commenti sulle segnalazioni che segue",
+      commentDescription: "Quando qualcuno commenta una segnalazione che ha scritto o commentato.",
     },
     feedbackContext: {
       user: "Utente",
@@ -148,6 +179,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       download: (name) => `Scarica ${name}`,
       downloadFailed: "Non è stato possibile scaricare l’allegato.",
       outcome: "Esito",
+      replies: "Risposte",
       resolvedAt: (date) => `Risolto il ${date}`,
       outcomeAdd: "Aggiungi esito",
       outcomeUpdate: "Aggiorna",
@@ -162,6 +194,36 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       status: "Stato",
       note: "Nota",
     },
+    // 0.38.0 — docs/feedback-harmonization.md §9.15: the vote, the comment thread, the replies.
+    feedbackVote: {
+      vote: "Lo voglio anch’io",
+      own: "La Sua segnalazione",
+    },
+    feedbackComments: {
+      comments: "Commenti",
+      empty: "Ancora nessun commento",
+      hidden: "Nascosto da un amministratore",
+      hide: "Nascondi",
+      unhide: "Mostra",
+      delete: "Elimina",
+      deleteTitle: "Eliminare questo commento?",
+      deleteBody: "Verrà rimosso per tutti. L’operazione non può essere annullata.",
+      field: "Scrivi un commento",
+      placeholder: "Scriva un commento…",
+      send: "Commenta",
+    },
+    feedbackReplies: {
+      replies: "Risposte",
+      empty: "Ancora nessuna risposta",
+      admin: "Admin",
+      statusChanged: "Stato cambiato in",
+      field: "Scrivi una risposta",
+      placeholder: "Scriva una risposta…",
+      reply: "Rispondi",
+      status: "Stato con la risposta",
+      noChange: "Nessuna modifica",
+      nudge: "Chi ha inviato la segnalazione non è stato avvisato. Aggiunga una risposta.",
+    },
     accountSettings: {
       profile: {
         title: "Profilo",

package/src/i18n/locales/zh.ts

@@ -48,6 +48,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       submitHint: (apple) => (apple ? "⌘ Enter 发送" : "Ctrl+Enter 发送"),
       cancel: "取消",
       save: "发送",
+      publicNotice: "其他用户将看到标题和正文（绝不会看到您的截图或文件）。",
     },
     feedbackThread: {
       thread: "评论",
@@ -98,6 +99,36 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       trigger: "发送反馈",
       myFeedback: "我的反馈",
       viewFeedback: "查看反馈",
+      allFeedback: "全部反馈",
+    },
+    // 0.38.0 — docs/feedback-harmonization.md §9: the public pages and the two feedback
+    // notification types.
+    feedbackPublic: {
+      title: "全部反馈",
+      sort: "排序",
+      sortNewest: "最新",
+      sortVotes: "最多人想要",
+      sortUpdated: "最近更新",
+      search: "搜索标题",
+      columnVotes: "票数",
+      total: (count) => `${n(count)} 条反馈`,
+      comments: (count) => `${n(count)} 条评论`,
+      votes: (count) => `${n(count)} 票`,
+      anonymous: "一位用户",
+      filedBy: (name) => `提交者：${name}`,
+      body: "描述",
+      conversation: "回复和评论",
+      loading: "加载中…",
+      empty: "暂无反馈",
+      visibleToOthers: "对他人可见",
+      visibleHint: "其他用户可以看到标题和正文，绝不会看到您的截图或文件。",
+      visibleLocked: "仅在反馈仍处于打开状态时可更改。",
+    },
+    feedbackNotificationTypes: {
+      answered: "您的反馈收到的回复",
+      answeredDescription: "当您提交或评论过的反馈收到回复时。",
+      comment: "您关注的反馈中的评论",
+      commentDescription: "当有人评论您提交或评论过的反馈时。",
     },
     feedbackContext: {
       user: "用户",
@@ -138,6 +169,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       download: (name) => `下载 ${name}`,
       downloadFailed: "无法下载附件。",
       outcome: "处理结果",
+      replies: "回复",
       resolvedAt: (date) => `解决日期：${date}`,
       outcomeAdd: "添加处理结果",
       outcomeUpdate: "更新",
@@ -151,6 +183,36 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       status: "状态",
       note: "备注",
     },
+    // 0.38.0 — docs/feedback-harmonization.md §9.15: the vote, the comment thread, the replies.
+    feedbackVote: {
+      vote: "我也需要",
+      own: "您的反馈",
+    },
+    feedbackComments: {
+      comments: "评论",
+      empty: "暂无评论",
+      hidden: "已被管理员隐藏",
+      hide: "隐藏",
+      unhide: "取消隐藏",
+      delete: "删除",
+      deleteTitle: "删除这条评论？",
+      deleteBody: "将对所有人移除，且无法撤销。",
+      field: "撰写评论",
+      placeholder: "撰写评论…",
+      send: "发表评论",
+    },
+    feedbackReplies: {
+      replies: "回复",
+      empty: "暂无回复",
+      admin: "管理员",
+      statusChanged: "状态已改为",
+      field: "撰写回复",
+      placeholder: "撰写回复…",
+      reply: "回复",
+      status: "随回复更改状态",
+      noChange: "不更改",
+      nudge: "尚未通知提交者。请添加回复。",
+    },
     accountSettings: {
       profile: {
         title: "个人资料",

package/src/i18n/review.ts

@@ -212,6 +212,10 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "feedbackPage.reworkChip": one,
   "feedbackDetail.download": [["{{name}}"]],
   "feedbackDetail.resolvedAt": [["{{date}}"]],
+  "feedbackPublic.total": one,
+  "feedbackPublic.comments": one,
+  "feedbackPublic.votes": one,
+  "feedbackPublic.filedBy": [["{{name}}"]],
   "accountSettings.passkeys.renameItem": [["{{name}}"]],
   "accountSettings.passkeys.renameField": [["{{name}}"]],
   "accountSettings.passkeys.deleteItem": [["{{name}}"]],

package/src/i18n/shared-labels.ts

@@ -37,7 +37,7 @@ export const DEFAULT_COMMON_LABELS: CommonLabels = {
   fieldValue: (field, value) => `${field}: ${value}`,
   dismiss: "Dismiss",
   opensInNewTab: "opens in a new tab",
-  aboutField: (field) => `About ${field}`,
+  aboutField: (field) => `About “${field}”`,
   help: "Help",
 };
 

package/src/index.ts

@@ -926,6 +926,15 @@ export { PushDevicesSetting, describeUserAgent } from "./notifications/push-devi
 export type { PushDevicesSettingProps } from "./notifications/push-devices-setting";
 export { UnsubscribePanel, unsubscribeTokenType } from "./notifications/unsubscribe-panel";
 export type { UnsubscribePanelProps } from "./notifications/unsubscribe-panel";
+// 0.38.0 (docs/feedback-harmonization.md §9.11): the two feedback types' setting words.
+export {
+  useFeedbackNotificationTypes,
+  DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS,
+} from "./notifications/feedback-notification-types";
+export type {
+  FeedbackNotificationTypeId,
+  FeedbackNotificationTypesLabels,
+} from "./notifications/feedback-notification-types";
 
 // ── landing ──────────────────────────────────────────────────────────────────
 // 0.31.0 (docs/landing-demo-harmonization.md): the public landing page. Its router-aware parts — the header and the resume (RootEntry,

package/src/lib/plain-text.ts

@@ -8,7 +8,7 @@ import type { ReactNode } from "react";
  * to find (an icon), so the caller falls back to a name of its own.
  *
  * Package-private — not re-exported from the barrel. StatTile names its sparkline by it;
- * a field names its `help` "?" by it ("About <label>", round 0.36).
+ * a field names its `help` "?" by it ("About “<label>”", round 0.36).
  */
 export function plainText(node: ReactNode): string | undefined {
   const walk = (n: ReactNode): string => {

package/src/notifications/feedback-notification-types-labels.ts

@@ -0,0 +1,24 @@
+// The English words of `useFeedbackNotificationTypes` (round 0.38), in a module with no
+// component code, as every `*-labels.ts`: the English catalogue imports them alone.
+
+/**
+ * `feedbackNotificationTypes` — the setting words of the two feedback notification types
+ * (docs/feedback-harmonization.md §9.11). In the kit, not in each app, because two apps
+ * declare them (keksdose, Kurvenschmiede; kastlan `feedback_answered` alone). The mail and
+ * push texts stay the app's.
+ */
+export interface FeedbackNotificationTypesLabels {
+  /** `feedback_answered`: a reply on a report the person wrote or commented on. */
+  answered: string;
+  answeredDescription: string;
+  /** `feedback_comment`: a visible comment on such a report. */
+  comment: string;
+  commentDescription: string;
+}
+
+export const DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS: FeedbackNotificationTypesLabels = {
+  answered: "Answers to your reports",
+  answeredDescription: "When a report you wrote or commented on gets an answer.",
+  comment: "Comments on reports you follow",
+  commentDescription: "When someone comments on a report you wrote or commented on.",
+};

package/src/notifications/feedback-notification-types.ts

@@ -0,0 +1,46 @@
+import { useMemo } from "react";
+import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
+import type { NotificationTypeEntry } from "./notification-types";
+import {
+  DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS,
+  type FeedbackNotificationTypesLabels,
+} from "./feedback-notification-types-labels";
+
+export { DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS };
+export type { FeedbackNotificationTypesLabels };
+
+/** The two feedback notification ids (§9.11), as server-kit's `FEEDBACK_ANSWERED` and
+ *  `FEEDBACK_COMMENT` name them. */
+export type FeedbackNotificationTypeId = "feedback_answered" | "feedback_comment";
+
+/**
+ * The setting words of the two feedback notification types (round 0.38,
+ * docs/feedback-harmonization.md §9.11), for `NotificationTypesSetting`'s `types`:
+ *
+ * ```tsx
+ * const feedbackTypes = useFeedbackNotificationTypes();
+ * <NotificationTypesSetting types={[...appTypes, ...feedbackTypes]} … />
+ * ```
+ *
+ * - **"Answers to your reports"** (`feedback_answered`): a reply from the admin or a
+ *   loop, to the author and every earlier commenter.
+ * - **"Comments on reports you follow"** (`feedback_comment`): a visible comment, to the
+ *   author and the earlier commenters.
+ *
+ * Both entries are always returned: the card draws a type only when the server answered
+ * it (notifications §2.1), so kastlan, which does not declare `feedback_comment` while its
+ * public parts are off, shows the first alone. Words: `<UiKitProvider labels={{
+ * feedbackNotificationTypes }}>` over English, `labels` over both.
+ */
+export function useFeedbackNotificationTypes(
+  labels?: LabelOverride<FeedbackNotificationTypesLabels>,
+): NotificationTypeEntry<FeedbackNotificationTypeId>[] {
+  const words = useKitLabels("feedbackNotificationTypes", DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS, labels);
+  return useMemo(
+    () => [
+      { id: "feedback_answered", label: words.answered, description: words.answeredDescription },
+      { id: "feedback_comment", label: words.comment, description: words.commentDescription },
+    ],
+    [words],
+  );
+}

package/src/rhf/fields.tsx

@@ -119,7 +119,7 @@ export interface RhfFieldBaseProps<
    *  `help` it is that caption at every size. */
   hint?: ReactNode;
   /** Help the field is usable without — why, how to choose — behind the field's one
-   *  "?" after the label: a `HelpPopover` named "About <label>" (round 0.36,
+   *  "?" after the label: a `HelpPopover` named "About “<label>”" (round 0.36,
    *  docs/text-size-harmonization.md §4); pass a `HelpPopover` to name it yourself.
    *  `hint` stays the visible fact under the field. */
   help?: ReactNode;

package/src/settings/device-reset-setting.tsx

@@ -67,10 +67,10 @@ export interface DeviceResetSettingProps
  * - **Live, no reload** (decision 10): each registered store resets through its own
  *   setter; the card stays where it is.
  *
- * The app adds the catalogue entry, `{ id: "device_reset", group: "appearance", anchor:
- * DEVICE_RESET_ANCHOR, title, keywords }` (`title` and `keywords` from these labels), last
- * in its appearance group: inside a `SettingsLayout`, `SettingsSection` throws in
- * development without it.
+ * The app adds the catalogue entry, `{ id, group: "appearance", anchor: DEVICE_RESET_ANCHOR,
+ * title, keywords }` (the id in its catalogue's own style, e.g. `device_reset` or
+ * `deviceReset`; `title` and `keywords` from these labels), last in its appearance group:
+ * inside a `SettingsLayout`, `SettingsSection` throws in development without it.
  */
 export function DeviceResetSetting({
   description,