@eifi1/ui-kit 0.17.0 → 0.19.0

package/dist/components/translation-review-labels.d.ts

@@ -0,0 +1,92 @@
+import { ReviewStatus } from '../lib/translation-review.js';
+
+/**
+ * The `translationReview` namespace: every word of the translation-review parts
+ * (`ReviewStatusChip`, `TranslationProgress`, `TranslationLocaleTabs`,
+ * `TranslationExportButton`, `TranslationReviewEditor`, `TranslationReviewPanel`).
+ *
+ * Its own module, like `data-table-labels.ts`: `kit-labels.tsx` and `defaults.ts` import
+ * it, and neither has to load the components to get the words. The English is keksdose's
+ * and kastlan's own (`translation_review.*`, `translations:*`), British.
+ */
+interface TranslationReviewLabels {
+    /** The five statuses — the chip, the filter, the progress legend. */
+    statusMissing: string;
+    statusUnreviewed: string;
+    statusChanged: string;
+    statusNeedsChange: string;
+    statusApproved: string;
+    /** Accessible name of the status filter. */
+    statusFilter: string;
+    /** The status filter's first option. */
+    all: string;
+    /** A status filter option with its count: "Unreviewed · 12". */
+    filterCount: (label: string, count: number) => string;
+    /** The source filter's label — shown only when the rows come from several sources
+     *  (kastlan's screen texts and documents). */
+    source: string;
+    allSources: string;
+    /** The namespace filter's label and its "every one" option. */
+    namespace: string;
+    allNamespaces: string;
+    search: string;
+    /** The placeholder filter, with how many rows it would show. */
+    placeholdersOnly: (count: number) => string;
+    /** The chip on a row whose placeholders differ from the reference's. */
+    placeholderChip: string;
+    /** The key column, and the key's caption in the editor. */
+    key: string;
+    statusColumn: string;
+    /** No row matches the filters. */
+    empty: string;
+    /** In place of the text of a string the locale lacks. */
+    missingText: string;
+    /** The progress bar's label. */
+    progress: (approved: number, total: number) => string;
+    /** A locale tab's badge. */
+    localeProgress: (approved: number, total: number) => string;
+    /** Accessible name of the locale tabs. */
+    locales: string;
+    approve: string;
+    /** Send a string back: "Needs a change". */
+    flag: string;
+    /** "Needs a change" for a MISSING string: the suggestion is the translation to add. */
+    suggest: string;
+    /** Clear a verdict: back to unreviewed. */
+    reset: string;
+    /** The editor's way out without saving. */
+    cancel: string;
+    approveSelected: string;
+    resetSelected: string;
+    /** Selects every row the filters show — the phone's way into the bulk actions, where
+     *  the table has no checkboxes. */
+    selectShown: string;
+    /** Over the old wording of a row that changed since its verdict. */
+    changedSince: string;
+    reviewedWording: string;
+    reviewedReference: string;
+    /** The placeholders differ: the reference's and the text's, each a list. */
+    placeholderMismatch: (reference: string, text: string) => string;
+    lastApproved: (name: string, date: string) => string;
+    lastFlagged: (name: string, date: string) => string;
+    /** The reviewer's name once the account is gone — what `name` above becomes. */
+    erasedReviewer: string;
+    /** The editor's wording field, opened on the current text. */
+    suggestion: string;
+    /** The same field for a missing string. */
+    translation: string;
+    note: string;
+    notePlaceholder: string;
+    /** The viewer may read this locale but not review it. */
+    readOnly: string;
+    /** The reviewer is limited to some areas — `areas` is their names, joined. */
+    scope: (areas: string) => string;
+    exportCorrections: (count: number) => string;
+    /** A callback rejected and no `formatError` says better. */
+    failed: string;
+}
+declare const DEFAULT_TRANSLATION_REVIEW_LABELS: TranslationReviewLabels;
+/** A status's word, from the namespace's five. */
+declare function reviewStatusLabel(labels: TranslationReviewLabels, status: ReviewStatus): string;
+
+export { DEFAULT_TRANSLATION_REVIEW_LABELS, type TranslationReviewLabels, reviewStatusLabel };

package/dist/components/translation-review-labels.js

@@ -0,0 +1,67 @@
+"use client";
+const DEFAULT_TRANSLATION_REVIEW_LABELS = {
+  statusMissing: "Missing",
+  statusUnreviewed: "Unreviewed",
+  statusChanged: "Changed since review",
+  statusNeedsChange: "Needs a change",
+  statusApproved: "Approved",
+  statusFilter: "Status",
+  all: "All",
+  filterCount: (label, count) => `${label} \xB7 ${count}`,
+  source: "Texts",
+  allSources: "All texts",
+  namespace: "Area",
+  allNamespaces: "All areas",
+  search: "Search keys and text",
+  placeholdersOnly: (count) => `Only placeholder problems (${count})`,
+  placeholderChip: "Placeholders",
+  key: "Key",
+  statusColumn: "Status",
+  empty: "No strings match these filters.",
+  missingText: "Missing in this language",
+  progress: (approved, total) => `${approved} of ${total} approved`,
+  localeProgress: (approved, total) => `${approved}/${total}`,
+  locales: "Languages",
+  approve: "Approve",
+  flag: "Needs a change",
+  suggest: "Suggest translation",
+  reset: "Mark unreviewed",
+  cancel: "Cancel",
+  approveSelected: "Approve selected",
+  resetSelected: "Mark selected unreviewed",
+  selectShown: "Select all shown",
+  changedSince: "This string changed after it was reviewed. Please read it again.",
+  reviewedWording: "Wording when reviewed",
+  reviewedReference: "Reference when reviewed",
+  placeholderMismatch: (reference, text) => `The placeholders differ from the reference \u2014 reference: ${reference}; this text: ${text}. The app fills these in, so they must stay exactly as they are.`,
+  lastApproved: (name, date) => `Approved by ${name} on ${date}`,
+  lastFlagged: (name, date) => `Marked as needing a change by ${name} on ${date}`,
+  erasedReviewer: "a deleted account",
+  suggestion: "Better wording",
+  translation: "Translation",
+  note: "Note (optional)",
+  notePlaceholder: "What is wrong, or what to keep in mind",
+  readOnly: "You can read this language but not review it.",
+  scope: (areas) => `Your review is limited to: ${areas}.`,
+  exportCorrections: (count) => `Export corrections (${count})`,
+  failed: "That did not work. Please try again."
+};
+function reviewStatusLabel(labels, status) {
+  switch (status) {
+    case "missing":
+      return labels.statusMissing;
+    case "unreviewed":
+      return labels.statusUnreviewed;
+    case "changed":
+      return labels.statusChanged;
+    case "needs_change":
+      return labels.statusNeedsChange;
+    case "approved":
+      return labels.statusApproved;
+  }
+}
+export {
+  DEFAULT_TRANSLATION_REVIEW_LABELS,
+  reviewStatusLabel
+};
+//# sourceMappingURL=translation-review-labels.js.map

package/dist/components/translation-review-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/translation-review-labels.ts"],"sourcesContent":["import type { ReviewStatus } from \"../lib/translation-review\";\n\n/**\n * The `translationReview` namespace: every word of the translation-review parts\n * (`ReviewStatusChip`, `TranslationProgress`, `TranslationLocaleTabs`,\n * `TranslationExportButton`, `TranslationReviewEditor`, `TranslationReviewPanel`).\n *\n * Its own module, like `data-table-labels.ts`: `kit-labels.tsx` and `defaults.ts` import\n * it, and neither has to load the components to get the words. The English is keksdose's\n * and kastlan's own (`translation_review.*`, `translations:*`), British.\n */\nexport interface TranslationReviewLabels {\n  /** The five statuses — the chip, the filter, the progress legend. */\n  statusMissing: string;\n  statusUnreviewed: string;\n  statusChanged: string;\n  statusNeedsChange: string;\n  statusApproved: string;\n  /** Accessible name of the status filter. */\n  statusFilter: string;\n  /** The status filter's first option. */\n  all: string;\n  /** A status filter option with its count: \"Unreviewed · 12\". */\n  filterCount: (label: string, count: number) => string;\n  /** The source filter's label — shown only when the rows come from several sources\n   *  (kastlan's screen texts and documents). */\n  source: string;\n  allSources: string;\n  /** The namespace filter's label and its \"every one\" option. */\n  namespace: string;\n  allNamespaces: string;\n  search: string;\n  /** The placeholder filter, with how many rows it would show. */\n  placeholdersOnly: (count: number) => string;\n  /** The chip on a row whose placeholders differ from the reference's. */\n  placeholderChip: string;\n  /** The key column, and the key's caption in the editor. */\n  key: string;\n  statusColumn: string;\n  /** No row matches the filters. */\n  empty: string;\n  /** In place of the text of a string the locale lacks. */\n  missingText: string;\n  /** The progress bar's label. */\n  progress: (approved: number, total: number) => string;\n  /** A locale tab's badge. */\n  localeProgress: (approved: number, total: number) => string;\n  /** Accessible name of the locale tabs. */\n  locales: string;\n  approve: string;\n  /** Send a string back: \"Needs a change\". */\n  flag: string;\n  /** \"Needs a change\" for a MISSING string: the suggestion is the translation to add. */\n  suggest: string;\n  /** Clear a verdict: back to unreviewed. */\n  reset: string;\n  /** The editor's way out without saving. */\n  cancel: string;\n  approveSelected: string;\n  resetSelected: string;\n  /** Selects every row the filters show — the phone's way into the bulk actions, where\n   *  the table has no checkboxes. */\n  selectShown: string;\n  /** Over the old wording of a row that changed since its verdict. */\n  changedSince: string;\n  reviewedWording: string;\n  reviewedReference: string;\n  /** The placeholders differ: the reference's and the text's, each a list. */\n  placeholderMismatch: (reference: string, text: string) => string;\n  lastApproved: (name: string, date: string) => string;\n  lastFlagged: (name: string, date: string) => string;\n  /** The reviewer's name once the account is gone — what `name` above becomes. */\n  erasedReviewer: string;\n  /** The editor's wording field, opened on the current text. */\n  suggestion: string;\n  /** The same field for a missing string. */\n  translation: string;\n  note: string;\n  notePlaceholder: string;\n  /** The viewer may read this locale but not review it. */\n  readOnly: string;\n  /** The reviewer is limited to some areas — `areas` is their names, joined. */\n  scope: (areas: string) => string;\n  exportCorrections: (count: number) => string;\n  /** A callback rejected and no `formatError` says better. */\n  failed: string;\n}\n\nexport const DEFAULT_TRANSLATION_REVIEW_LABELS: TranslationReviewLabels = {\n  statusMissing: \"Missing\",\n  statusUnreviewed: \"Unreviewed\",\n  statusChanged: \"Changed since review\",\n  statusNeedsChange: \"Needs a change\",\n  statusApproved: \"Approved\",\n  statusFilter: \"Status\",\n  all: \"All\",\n  filterCount: (label, count) => `${label} · ${count}`,\n  source: \"Texts\",\n  allSources: \"All texts\",\n  namespace: \"Area\",\n  allNamespaces: \"All areas\",\n  search: \"Search keys and text\",\n  placeholdersOnly: (count) => `Only placeholder problems (${count})`,\n  placeholderChip: \"Placeholders\",\n  key: \"Key\",\n  statusColumn: \"Status\",\n  empty: \"No strings match these filters.\",\n  missingText: \"Missing in this language\",\n  progress: (approved, total) => `${approved} of ${total} approved`,\n  localeProgress: (approved, total) => `${approved}/${total}`,\n  locales: \"Languages\",\n  approve: \"Approve\",\n  flag: \"Needs a change\",\n  suggest: \"Suggest translation\",\n  reset: \"Mark unreviewed\",\n  cancel: \"Cancel\",\n  approveSelected: \"Approve selected\",\n  resetSelected: \"Mark selected unreviewed\",\n  selectShown: \"Select all shown\",\n  changedSince: \"This string changed after it was reviewed. Please read it again.\",\n  reviewedWording: \"Wording when reviewed\",\n  reviewedReference: \"Reference when reviewed\",\n  placeholderMismatch: (reference, text) =>\n    `The placeholders differ from the reference — reference: ${reference}; this text: ${text}. The app fills these in, so they must stay exactly as they are.`,\n  lastApproved: (name, date) => `Approved by ${name} on ${date}`,\n  lastFlagged: (name, date) => `Marked as needing a change by ${name} on ${date}`,\n  erasedReviewer: \"a deleted account\",\n  suggestion: \"Better wording\",\n  translation: \"Translation\",\n  note: \"Note (optional)\",\n  notePlaceholder: \"What is wrong, or what to keep in mind\",\n  readOnly: \"You can read this language but not review it.\",\n  scope: (areas) => `Your review is limited to: ${areas}.`,\n  exportCorrections: (count) => `Export corrections (${count})`,\n  failed: \"That did not work. Please try again.\",\n};\n\n/** A status's word, from the namespace's five. */\nexport function reviewStatusLabel(labels: TranslationReviewLabels, status: ReviewStatus): string {\n  switch (status) {\n    case \"missing\":\n      return labels.statusMissing;\n    case \"unreviewed\":\n      return labels.statusUnreviewed;\n    case \"changed\":\n      return labels.statusChanged;\n    case \"needs_change\":\n      return labels.statusNeedsChange;\n    case \"approved\":\n      return labels.statusApproved;\n  }\n}\n"],"mappings":";AAwFO,MAAM,oCAA6D;AAAA,EACxE,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,cAAc;AAAA,EACd,KAAK;AAAA,EACL,aAAa,CAAC,OAAO,UAAU,GAAG,KAAK,SAAM,KAAK;AAAA,EAClD,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,eAAe;AAAA,EACf,QAAQ;AAAA,EACR,kBAAkB,CAAC,UAAU,8BAA8B,KAAK;AAAA,EAChE,iBAAiB;AAAA,EACjB,KAAK;AAAA,EACL,cAAc;AAAA,EACd,OAAO;AAAA,EACP,aAAa;AAAA,EACb,UAAU,CAAC,UAAU,UAAU,GAAG,QAAQ,OAAO,KAAK;AAAA,EACtD,gBAAgB,CAAC,UAAU,UAAU,GAAG,QAAQ,IAAI,KAAK;AAAA,EACzD,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,qBAAqB,CAAC,WAAW,SAC/B,gEAA2D,SAAS,gBAAgB,IAAI;AAAA,EAC1F,cAAc,CAAC,MAAM,SAAS,eAAe,IAAI,OAAO,IAAI;AAAA,EAC5D,aAAa,CAAC,MAAM,SAAS,iCAAiC,IAAI,OAAO,IAAI;AAAA,EAC7E,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,MAAM;AAAA,EACN,iBAAiB;AAAA,EACjB,UAAU;AAAA,EACV,OAAO,CAAC,UAAU,8BAA8B,KAAK;AAAA,EACrD,mBAAmB,CAAC,UAAU,uBAAuB,KAAK;AAAA,EAC1D,QAAQ;AACV;AAGO,SAAS,kBAAkB,QAAiC,QAA8B;AAC/F,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,EAClB;AACF;","names":[]}

package/dist/components/translation-review-parts.d.ts

@@ -0,0 +1,97 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { ReviewStatus, TranslationRow, TranslationCorrection, TranslationSummary } from '../lib/translation-review.js';
+import { ChipTone, ChipSize, ChipVariant, ChipShape } from './chip.js';
+import { TranslationReviewLabels } from './translation-review-labels.js';
+import 'lucide-react';
+
+/**
+ * The small parts of the translation review, each usable on its own: the status
+ * vocabulary as a chip, one locale's progress, the locale tabs and the export. The page
+ * body that puts them together is `TranslationReviewPanel` (translation-review.tsx).
+ */
+/**
+ * The tone of each status: nothing yet is neutral, a gap is orange (kastlan's choice — a
+ * hue, not a verdict), a change since review is amber, sent back is red, done is green.
+ */
+declare const REVIEW_STATUS_TONES: Readonly<Record<ReviewStatus, ChipTone>>;
+interface ReviewStatusChipProps {
+    status: ReviewStatus;
+    /** Over {@link REVIEW_STATUS_TONES}. */
+    tone?: ChipTone;
+    /** Over the label. */
+    children?: ReactNode;
+    /** Default `sm` — a chip in a table cell. */
+    size?: ChipSize;
+    variant?: ChipVariant;
+    shape?: ChipShape;
+    caps?: boolean;
+    className?: string;
+    /** Prop > `<UiKitProvider labels={{ translationReview }}>` > English. */
+    labels?: Partial<TranslationReviewLabels>;
+    [key: `data-${string}`]: string | number | boolean | undefined;
+}
+/** One row's status as a chip, in the kit's words and tones. Carries `data-status`. */
+declare function ReviewStatusChip({ status, tone, children, size, variant, shape, caps, className, labels: labelsProp, ...rest }: ReviewStatusChipProps): react.JSX.Element;
+interface TranslationProgressProps {
+    /** One locale's rows — or their {@link summariseRows} when the app has only counts. */
+    rows?: readonly TranslationRow[];
+    summary?: TranslationSummary;
+    /** The list under the bar naming each part with its count. Default true. */
+    legend?: boolean;
+    className?: string;
+    labels?: Partial<TranslationReviewLabels>;
+}
+/**
+ * "120 of 3859 approved", and the bar split by status: approved, sent back, changed since
+ * review, missing — in the chips' colours. What is left of the track is unreviewed. The
+ * legend counts rows rather than percentages: "12 need a change" is the next hour's work,
+ * "0.3 %" is not.
+ */
+declare function TranslationProgress({ rows, summary: summaryProp, legend, className, labels: labelsProp, }: TranslationProgressProps): react.JSX.Element;
+interface TranslationLocaleTab {
+    /** The locale code. */
+    value: string;
+    /** Its name, in its own language ("Français"). */
+    label: ReactNode;
+    /** The locale's rows, for the badge — built with the same `areas` as the panel's, so
+     *  a scoped reviewer's tab counts what they can see. */
+    rows: readonly TranslationRow[];
+}
+interface TranslationLocaleTabsProps {
+    /** The locales the viewer may see, in the app's order — the server's answer, never a
+     *  guess from a role name. */
+    locales: readonly TranslationLocaleTab[];
+    active: string;
+    onChange: (locale: string) => void;
+    className?: string;
+    labels?: Partial<TranslationReviewLabels>;
+}
+/**
+ * One tab per locale with its approved/total, wrapping on a phone. Nothing for a single
+ * locale: a strip with one tab is a heading that looks clickable.
+ */
+declare function TranslationLocaleTabs({ locales, active, onChange, className, labels: labelsProp }: TranslationLocaleTabsProps): react.JSX.Element | null;
+interface TranslationExportButtonProps {
+    /** Every row the export covers — usually every locale's, not only the open one. */
+    rows: readonly TranslationRow[];
+    /** Listed in the file. Default: the locales the rows come from. */
+    locales?: readonly string[];
+    /** Default `translation-corrections-<date>.json`. */
+    fileName?: string;
+    /**
+     * Take the export instead of downloading it — the entries, and the file as a ready
+     * JSON Blob. Left out, the kit downloads the Blob as `fileName`.
+     */
+    onExport?: (corrections: TranslationCorrection[], file: Blob) => void;
+    className?: string;
+    labels?: Partial<TranslationReviewLabels>;
+}
+/**
+ * "Export corrections (n)": every string sent back, as the JSON file keksdose and kastlan
+ * hand a developer — `{ exported_at, locales, corrections }`. Corrections are not applied
+ * on the page: the strings are source code. Disabled while there is nothing to export.
+ */
+declare function TranslationExportButton({ rows, locales, fileName, onExport, className, labels: labelsProp, }: TranslationExportButtonProps): react.JSX.Element;
+
+export { REVIEW_STATUS_TONES, ReviewStatusChip, type ReviewStatusChipProps, TranslationExportButton, type TranslationExportButtonProps, type TranslationLocaleTab, TranslationLocaleTabs, type TranslationLocaleTabsProps, TranslationProgress, type TranslationProgressProps };

package/dist/components/translation-review-parts.js

@@ -0,0 +1,163 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Download } from "lucide-react";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { useKitFormat } from "../lib/format.js";
+import { summariseRows, translationCorrections } from "../lib/translation-review.js";
+import { Chip } from "./chip.js";
+import { ProgressBar } from "./progress-bar.js";
+import { DEFAULT_TRANSLATION_REVIEW_LABELS, reviewStatusLabel } from "./translation-review-labels.js";
+import { Button, Tabs } from "./ui.js";
+const REVIEW_STATUS_TONES = {
+  missing: "orange",
+  unreviewed: "neutral",
+  changed: "warning",
+  needs_change: "danger",
+  approved: "success"
+};
+function ReviewStatusChip({
+  status,
+  tone,
+  children,
+  size = "sm",
+  variant,
+  shape,
+  caps,
+  className,
+  labels: labelsProp,
+  ...rest
+}) {
+  const labels = useKitLabels("translationReview", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);
+  return /* @__PURE__ */ jsx(
+    Chip,
+    {
+      ...rest,
+      "data-status": status,
+      tone: tone ?? REVIEW_STATUS_TONES[status],
+      size,
+      variant,
+      shape,
+      caps,
+      className,
+      children: children ?? reviewStatusLabel(labels, status)
+    }
+  );
+}
+function TranslationProgress({
+  rows,
+  summary: summaryProp,
+  legend = true,
+  className,
+  labels: labelsProp
+}) {
+  const labels = useKitLabels("translationReview", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);
+  const { formatNumber } = useKitFormat();
+  const summary = useMemo(() => summaryProp ?? summariseRows(rows ?? []), [summaryProp, rows]);
+  const part = (status, tone, color) => ({
+    key: status,
+    value: summary[status],
+    tone,
+    color,
+    label: reviewStatusLabel(labels, status),
+    // A status with no rows stays in the legend ("Needs a change 0" is news too) but out
+    // of the bar, where it would only be a gap.
+    legendOnly: summary[status] === 0 ? true : void 0
+  });
+  const segments = [
+    part("approved", "success"),
+    part("needs_change", "danger"),
+    part("changed", "warning"),
+    // The chip's orange, which is a hue and not a ProgressBar tone. Only where there is
+    // a gap: an app whose locales are complete never hears of "missing".
+    ...summary.missing > 0 ? [part("missing", void 0, "var(--hue-orange)")] : []
+  ];
+  return /* @__PURE__ */ jsx(
+    ProgressBar,
+    {
+      className,
+      label: labels.progress(summary.approved, summary.total),
+      max: Math.max(summary.total, 1),
+      segments,
+      legend,
+      formatValue: (value) => formatNumber(value)
+    }
+  );
+}
+function TranslationLocaleTabs({ locales, active, onChange, className, labels: labelsProp }) {
+  const labels = useKitLabels("translationReview", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);
+  if (locales.length < 2) return null;
+  return /* @__PURE__ */ jsx(
+    Tabs,
+    {
+      "aria-label": labels.locales,
+      wrap: true,
+      className,
+      tabs: locales.map((locale) => {
+        const summary = summariseRows(locale.rows);
+        return {
+          id: locale.value,
+          label: locale.label,
+          name: typeof locale.label === "string" ? locale.label : locale.value,
+          badge: (
+            // The tab's own colour, dimmed — a fixed muted grey vanished on the selected
+            // tab's brand fill (390px browser check).
+            /* @__PURE__ */ jsx("span", { className: "text-xs tabular-nums opacity-75", children: labels.localeProgress(summary.approved, summary.total) })
+          )
+        };
+      }),
+      active,
+      onChange
+    }
+  );
+}
+function TranslationExportButton({
+  rows,
+  locales,
+  fileName,
+  onExport,
+  className,
+  labels: labelsProp
+}) {
+  const labels = useKitLabels("translationReview", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);
+  const corrections = useMemo(() => translationCorrections(rows), [rows]);
+  const run = () => {
+    const now = /* @__PURE__ */ new Date();
+    const file = new Blob(
+      [
+        JSON.stringify(
+          {
+            exported_at: now.toISOString(),
+            locales: locales ?? [...new Set(rows.map((r) => r.locale))],
+            corrections
+          },
+          null,
+          2
+        )
+      ],
+      { type: "application/json" }
+    );
+    if (onExport) {
+      onExport(corrections, file);
+      return;
+    }
+    const url = URL.createObjectURL(file);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = fileName ?? `translation-corrections-${now.toISOString().slice(0, 10)}.json`;
+    a.click();
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+  };
+  return /* @__PURE__ */ jsxs(Button, { variant: "secondary", disabled: corrections.length === 0, onClick: run, className, children: [
+    /* @__PURE__ */ jsx(Download, { className: "size-4", "aria-hidden": true }),
+    labels.exportCorrections(corrections.length)
+  ] });
+}
+export {
+  REVIEW_STATUS_TONES,
+  ReviewStatusChip,
+  TranslationExportButton,
+  TranslationLocaleTabs,
+  TranslationProgress
+};
+//# sourceMappingURL=translation-review-parts.js.map

package/dist/components/translation-review-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/translation-review-parts.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Download } from \"lucide-react\";\n\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { useKitFormat } from \"../lib/format\";\nimport { summariseRows, translationCorrections } from \"../lib/translation-review\";\nimport type {\n  ReviewStatus,\n  TranslationCorrection,\n  TranslationRow,\n  TranslationSummary,\n} from \"../lib/translation-review\";\nimport { Chip } from \"./chip\";\nimport type { ChipShape, ChipSize, ChipTone, ChipVariant } from \"./chip\";\nimport { ProgressBar } from \"./progress-bar\";\nimport type { ProgressBarSegment } from \"./progress-bar\";\nimport { DEFAULT_TRANSLATION_REVIEW_LABELS, reviewStatusLabel } from \"./translation-review-labels\";\nimport type { TranslationReviewLabels } from \"./translation-review-labels\";\nimport { Button, Tabs } from \"./ui\";\n\n/**\n * The small parts of the translation review, each usable on its own: the status\n * vocabulary as a chip, one locale's progress, the locale tabs and the export. The page\n * body that puts them together is `TranslationReviewPanel` (translation-review.tsx).\n */\n\n// ── ReviewStatusChip ──────────────────────────────────────────────────────────\n\n/**\n * The tone of each status: nothing yet is neutral, a gap is orange (kastlan's choice — a\n * hue, not a verdict), a change since review is amber, sent back is red, done is green.\n */\nexport const REVIEW_STATUS_TONES: Readonly<Record<ReviewStatus, ChipTone>> = {\n  missing: \"orange\",\n  unreviewed: \"neutral\",\n  changed: \"warning\",\n  needs_change: \"danger\",\n  approved: \"success\",\n};\n\nexport interface ReviewStatusChipProps {\n  status: ReviewStatus;\n  /** Over {@link REVIEW_STATUS_TONES}. */\n  tone?: ChipTone;\n  /** Over the label. */\n  children?: ReactNode;\n  /** Default `sm` — a chip in a table cell. */\n  size?: ChipSize;\n  variant?: ChipVariant;\n  shape?: ChipShape;\n  caps?: boolean;\n  className?: string;\n  /** Prop > `<UiKitProvider labels={{ translationReview }}>` > English. */\n  labels?: Partial<TranslationReviewLabels>;\n  [key: `data-${string}`]: string | number | boolean | undefined;\n}\n\n/** One row's status as a chip, in the kit's words and tones. Carries `data-status`. */\nexport function ReviewStatusChip({\n  status,\n  tone,\n  children,\n  size = \"sm\",\n  variant,\n  shape,\n  caps,\n  className,\n  labels: labelsProp,\n  ...rest\n}: ReviewStatusChipProps) {\n  const labels = useKitLabels(\"translationReview\", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);\n  return (\n    <Chip\n      {...rest}\n      data-status={status}\n      tone={tone ?? REVIEW_STATUS_TONES[status]}\n      size={size}\n      variant={variant}\n      shape={shape}\n      caps={caps}\n      className={className}\n    >\n      {children ?? reviewStatusLabel(labels, status)}\n    </Chip>\n  );\n}\n\n// ── TranslationProgress ───────────────────────────────────────────────────────\n\nexport interface TranslationProgressProps {\n  /** One locale's rows — or their {@link summariseRows} when the app has only counts. */\n  rows?: readonly TranslationRow[];\n  summary?: TranslationSummary;\n  /** The list under the bar naming each part with its count. Default true. */\n  legend?: boolean;\n  className?: string;\n  labels?: Partial<TranslationReviewLabels>;\n}\n\n/**\n * \"120 of 3859 approved\", and the bar split by status: approved, sent back, changed since\n * review, missing — in the chips' colours. What is left of the track is unreviewed. The\n * legend counts rows rather than percentages: \"12 need a change\" is the next hour's work,\n * \"0.3 %\" is not.\n */\nexport function TranslationProgress({\n  rows,\n  summary: summaryProp,\n  legend = true,\n  className,\n  labels: labelsProp,\n}: TranslationProgressProps) {\n  const labels = useKitLabels(\"translationReview\", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);\n  const { formatNumber } = useKitFormat();\n  const summary = useMemo(() => summaryProp ?? summariseRows(rows ?? []), [summaryProp, rows]);\n  const part = (status: ReviewStatus, tone: ProgressBarSegment[\"tone\"], color?: string): ProgressBarSegment => ({\n    key: status,\n    value: summary[status],\n    tone,\n    color,\n    label: reviewStatusLabel(labels, status),\n    // A status with no rows stays in the legend (\"Needs a change 0\" is news too) but out\n    // of the bar, where it would only be a gap.\n    legendOnly: summary[status] === 0 ? true : undefined,\n  });\n  const segments = [\n    part(\"approved\", \"success\"),\n    part(\"needs_change\", \"danger\"),\n    part(\"changed\", \"warning\"),\n    // The chip's orange, which is a hue and not a ProgressBar tone. Only where there is\n    // a gap: an app whose locales are complete never hears of \"missing\".\n    ...(summary.missing > 0 ? [part(\"missing\", undefined, \"var(--hue-orange)\")] : []),\n  ];\n  return (\n    <ProgressBar\n      className={className}\n      label={labels.progress(summary.approved, summary.total)}\n      max={Math.max(summary.total, 1)}\n      segments={segments}\n      legend={legend}\n      formatValue={(value) => formatNumber(value)}\n    />\n  );\n}\n\n// ── TranslationLocaleTabs ─────────────────────────────────────────────────────\n\nexport interface TranslationLocaleTab {\n  /** The locale code. */\n  value: string;\n  /** Its name, in its own language (\"Français\"). */\n  label: ReactNode;\n  /** The locale's rows, for the badge — built with the same `areas` as the panel's, so\n   *  a scoped reviewer's tab counts what they can see. */\n  rows: readonly TranslationRow[];\n}\n\nexport interface TranslationLocaleTabsProps {\n  /** The locales the viewer may see, in the app's order — the server's answer, never a\n   *  guess from a role name. */\n  locales: readonly TranslationLocaleTab[];\n  active: string;\n  onChange: (locale: string) => void;\n  className?: string;\n  labels?: Partial<TranslationReviewLabels>;\n}\n\n/**\n * One tab per locale with its approved/total, wrapping on a phone. Nothing for a single\n * locale: a strip with one tab is a heading that looks clickable.\n */\nexport function TranslationLocaleTabs({ locales, active, onChange, className, labels: labelsProp }: TranslationLocaleTabsProps) {\n  const labels = useKitLabels(\"translationReview\", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);\n  if (locales.length < 2) return null;\n  return (\n    <Tabs\n      aria-label={labels.locales}\n      wrap\n      className={className}\n      tabs={locales.map((locale) => {\n        const summary = summariseRows(locale.rows);\n        return {\n          id: locale.value,\n          label: locale.label,\n          name: typeof locale.label === \"string\" ? locale.label : locale.value,\n          badge: (\n            // The tab's own colour, dimmed — a fixed muted grey vanished on the selected\n            // tab's brand fill (390px browser check).\n            <span className=\"text-xs tabular-nums opacity-75\">\n              {labels.localeProgress(summary.approved, summary.total)}\n            </span>\n          ),\n        };\n      })}\n      active={active}\n      onChange={onChange}\n    />\n  );\n}\n\n// ── TranslationExportButton ───────────────────────────────────────────────────\n\nexport interface TranslationExportButtonProps {\n  /** Every row the export covers — usually every locale's, not only the open one. */\n  rows: readonly TranslationRow[];\n  /** Listed in the file. Default: the locales the rows come from. */\n  locales?: readonly string[];\n  /** Default `translation-corrections-<date>.json`. */\n  fileName?: string;\n  /**\n   * Take the export instead of downloading it — the entries, and the file as a ready\n   * JSON Blob. Left out, the kit downloads the Blob as `fileName`.\n   */\n  onExport?: (corrections: TranslationCorrection[], file: Blob) => void;\n  className?: string;\n  labels?: Partial<TranslationReviewLabels>;\n}\n\n/**\n * \"Export corrections (n)\": every string sent back, as the JSON file keksdose and kastlan\n * hand a developer — `{ exported_at, locales, corrections }`. Corrections are not applied\n * on the page: the strings are source code. Disabled while there is nothing to export.\n */\nexport function TranslationExportButton({\n  rows,\n  locales,\n  fileName,\n  onExport,\n  className,\n  labels: labelsProp,\n}: TranslationExportButtonProps) {\n  const labels = useKitLabels(\"translationReview\", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);\n  const corrections = useMemo(() => translationCorrections(rows), [rows]);\n  const run = () => {\n    const now = new Date();\n    const file = new Blob(\n      [\n        JSON.stringify(\n          {\n            exported_at: now.toISOString(),\n            locales: locales ?? [...new Set(rows.map((r) => r.locale))],\n            corrections,\n          },\n          null,\n          2,\n        ),\n      ],\n      { type: \"application/json\" },\n    );\n    if (onExport) {\n      onExport(corrections, file);\n      return;\n    }\n    const url = URL.createObjectURL(file);\n    const a = document.createElement(\"a\");\n    a.href = url;\n    a.download = fileName ?? `translation-corrections-${now.toISOString().slice(0, 10)}.json`;\n    a.click();\n    // After the click has handed the URL to the download, not before.\n    setTimeout(() => URL.revokeObjectURL(url), 0);\n  };\n  return (\n    <Button variant=\"secondary\" disabled={corrections.length === 0} onClick={run} className={className}>\n      <Download className=\"size-4\" aria-hidden />\n      {labels.exportCorrections(corrections.length)}\n    </Button>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/translation-review.d.ts

@@ -0,0 +1,94 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { TranslationRow, TranslationReviewWrite, TranslationReviewKey, TranslationReviewFilter } from '../lib/translation-review.js';
+import { TranslationReviewLabels } from './translation-review-labels.js';
+export { DEFAULT_TRANSLATION_REVIEW_LABELS } from './translation-review-labels.js';
+export { REVIEW_STATUS_TONES, ReviewStatusChip, ReviewStatusChipProps, TranslationExportButton, TranslationExportButtonProps, TranslationLocaleTab, TranslationLocaleTabs, TranslationLocaleTabsProps, TranslationProgress, TranslationProgressProps } from './translation-review-parts.js';
+export { TranslationReviewEditor, TranslationReviewEditorProps } from './translation-review-editor.js';
+import './chip.js';
+import 'lucide-react';
+
+/**
+ * An app's translation review page, as kit parts (H1, docs/i18n-harmonization.md):
+ * keksdose's /translations, which kastlan was about to build a second time. The app keeps
+ * what is its own — where the strings come from, which locale is read against which, who
+ * may review what, every request — and hands the kit rows (`translationRows`) and two
+ * callbacks. Everything a reviewer touches is here.
+ *
+ * Presentational — no request, no route — and one LOCALE at a time. Its table is the
+ * kit's DataTable, so like every DataTable it renders under the app's Router. The page
+ * around it puts
+ * {@link TranslationLocaleTabs} above it and {@link TranslationExportButton} in its header,
+ * because both span every locale while this panel is the one open.
+ *
+ * Callbacks may return promises, and the panel waits for them: an editor stays open with
+ * its text and the error when a save is refused (a 403 for a key outside the reviewer's
+ * areas, a network failure), a bulk action keeps its selection. Chunking a long bulk
+ * write to the server's batch limit is the app's; the panel sends one call per action.
+ */
+type MaybePromise = void | Promise<unknown>;
+interface TranslationReviewPanelProps {
+    /** One locale's rows, from `translationRows`. */
+    rows: readonly TranslationRow[];
+    /** The reviewed language's own name — the text column's header ("Français"). */
+    localeLabel: string;
+    /** The reference language's own name — the reference column's header. */
+    referenceLabel: string;
+    /** Store verdicts: one for an editor or a row's approve button, many for a bulk
+     *  approve. Left out (or `readOnly`): nothing can be changed. */
+    onSave?: (writes: TranslationReviewWrite[]) => MaybePromise;
+    /** Clear verdicts — back to unreviewed. Left out: no reset. */
+    onClear?: (keys: TranslationReviewKey[]) => MaybePromise;
+    /** A locale the viewer may read but not review: the rows and their verdicts, no
+     *  actions, and a line saying so. */
+    readOnly?: boolean;
+    /**
+     * The areas the reviewer is limited to (keksdose's lawyer: `["legal"]`), as the server
+     * answers them; `null` is every area. Rows outside are not shown or counted — build the
+     * rows with the same `areas` and they never exist — and a notice names the areas.
+     */
+    areas?: readonly string[] | null;
+    /** An area's name for the notice ("the legal pages (Imprint, …)"). Default: the key. */
+    areaLabels?: Readonly<Record<string, string>>;
+    /** Default `keyInArea`: the key is the area or sits under it (`legal.…`, `legal:…`). */
+    inArea?: (key: string, area: string) => boolean;
+    /** A source's name for the source filter, which appears once the rows come from more
+     *  than one (kastlan: `{ screen: "Screen", documents: "PDFs and emails" }`). Default:
+     *  the source itself. */
+    sourceLabels?: Readonly<Record<string, string>>;
+    /**
+     * Controlled filters — for an app that keeps them in the URL (keksdose's `?status=`,
+     * `?area=`, `?q=`). Whatever is left out is the panel's own. Pair with `onFilterChange`.
+     */
+    filter?: Partial<TranslationReviewFilter>;
+    onFilterChange?: (filter: TranslationReviewFilter) => void;
+    /** The progress bar over the filters. Default true. */
+    progress?: boolean;
+    /** Rows per page. Default 50. */
+    pageSize?: number;
+    /** Persists the table's sort and page size (DataTable's `storageKey`). */
+    storageKey?: string;
+    /** How a verdict's date reads in the editor. */
+    formatDate?: (iso: string) => string;
+    /** Turns a callback's rejection into words. Default {@link TranslationReviewLabels.failed}. */
+    formatError?: (error: unknown) => ReactNode;
+    className?: string;
+    labels?: Partial<TranslationReviewLabels>;
+}
+/**
+ * The page body for one locale: progress, filters (status, source, namespace, search,
+ * placeholder problems), the strings with an editor that unfolds under each, and the
+ * bulk actions over a selection.
+ *
+ * The status filter is the work queue in order — what is not there, what nobody has
+ * read, what changed after it was read, what was sent back, what is done — with each
+ * count on it. "Missing" is offered only where something is.
+ *
+ * Bulk approve takes the selected rows that are not approved yet and have a text:
+ * approving an absent string says nothing, and re-approving one says it again. On a
+ * phone the table has no checkboxes, so "Select all shown" selects what the filters
+ * show — filter to `Unreviewed` in one area, read, select, approve.
+ */
+declare function TranslationReviewPanel({ rows: rowsProp, localeLabel, referenceLabel, onSave, onClear, readOnly, areas, areaLabels, inArea, sourceLabels, filter: filterProp, onFilterChange, progress, pageSize, storageKey, formatDate, formatError, className, labels: labelsProp, }: TranslationReviewPanelProps): react.JSX.Element;
+
+export { TranslationReviewLabels, TranslationReviewPanel, type TranslationReviewPanelProps };