@miragon/mcp-toolkit-ui 2.6.0 → 2.8.0

package/src/locale/message-types.ts

@@ -0,0 +1,337 @@
+/**
+ * The shapes of the toolkit's message catalogs (see `toolkit-messages.ts`).
+ * Types only, kept apart from the catalogs so `messages-en.ts` /
+ * `messages-de.ts` can implement them without an import cycle.
+ */
+
+/** Strings shared by several components. */
+export interface CommonMessages {
+  /** Accessible name of the close button in dialogs and sheets. */
+  close: string
+  /** Retry action of error states. */
+  retry: string
+  /** Summary of a technical-details disclosure. */
+  details: string
+  /** Accessible name of a toast's close button. */
+  dismiss: string
+  /**
+   * @deprecated No longer rendered: the toast region is a plain live region
+   * with fixed attributes and takes no name. Kept so a catalog that sets it
+   * still type-checks.
+   */
+  notifications: string
+  /** Title of a widget's error state when its data could not be loaded. */
+  loadFailed: string
+  /** The line under {@link CommonMessages.loadFailed}: what you can do (a retry follows). */
+  loadFailedHint: string
+}
+
+/** Strings of the `McpAppView` chrome (placeholder, error state, toolbar, step errors). */
+export interface ViewMessages {
+  /** Placeholder text while the view's data is on its way. */
+  loading: string
+  /** Shown instead of the placeholder when the host cancelled the rendering call. */
+  cancelled: string
+  /** Accessible name of the refresh icon button. */
+  refresh: string
+  /** Accessible name of the refresh icon button while a refresh runs. */
+  refreshing: string
+  /** Accessible name of the fullscreen icon button (inline view). */
+  enterFullscreen: string
+  /** Accessible name of the fullscreen icon button (fullscreen view). */
+  exitFullscreen: string
+  /** Label of the button that opens the view builder. */
+  build: string
+  /** Shown under the placeholder once loading takes longer than `slowHintAfterMs`. */
+  slowHint: string
+  /** Title of the error state when the view could not be loaded. */
+  errorTitle: string
+  /** One line under the error title: what you can do next (a retry button follows). */
+  errorHint: string
+  /**
+   * The line under an error title when no retry is offered (the originating
+   * tool is unknown, or the view cannot refresh): what you can do instead.
+   */
+  errorHintNoRetry: string
+  /** Retry button of the error state and of the step-error alert. */
+  retry: string
+  /**
+   * Title of the notice shown instead of the view when the tool ran, the chat
+   * did not pass its result to the view, and the view must not run it again
+   * on its own (the recovery policy forbids it). Nothing failed.
+   */
+  blockedTitle: string
+  /** The line under {@link ViewMessages.blockedTitle} when the notice offers to load the view. */
+  blockedHint: string
+  /**
+   * The line under {@link ViewMessages.blockedTitle} when the tool writes, so
+   * the view offers no button that would run it again: what you can do instead.
+   */
+  blockedHintNoRetry: string
+  /** Button of that notice: loads the view by running the (non-writing) tool again. */
+  blockedRetry: string
+  /** Summary of the error's technical-details disclosure. */
+  errorDetails: string
+  /** Title of the alert that lists the data steps that failed. */
+  stepErrorsTitle: string
+  /** The line under the step-error title when a retry is offered: what it does. */
+  stepErrorsHint: string
+  /** Toast title when a refresh failed: what happened, in one short sentence. */
+  refreshFailed: string
+  /** Toast line under {@link ViewMessages.refreshFailed}: what you see now and can do. */
+  refreshFailedHint: string
+  /** Toast title when the host rejected a display-mode change. */
+  fullscreenFailed: string
+  /** Toast line under {@link ViewMessages.fullscreenFailed}: what you can do. */
+  fullscreenFailedHint: string
+  /**
+   * The line under the toolbar title of a view that loaded its data again
+   * itself (the host did not pass the original result along, or the user
+   * retried or refreshed), with the time pre-formatted (`formatClockTime`, in
+   * the language of these words). It must carry its meaning in its own
+   * words: there is no tooltip, so touch and keyboard users read only this.
+   */
+  dataAsOf: (time: string) => string
+}
+
+/** Strings of `ListFooter`. */
+export interface ListFooterMessages {
+  /** The honest count line, e.g. "Showing 8 of 42 tasks". Numbers arrive pre-formatted. */
+  showing: (params: { shown: string; total: string; noun: string }) => string
+  /** Plural noun used when the caller passes none. */
+  defaultNoun: string
+  loadMore: string
+  loadingMore: string
+  /** Status while a new first page is in flight over the rows on screen. */
+  updating: string
+  /**
+   * Status at zero rows, for screen readers only (the caller's empty state is
+   * what you see): a search that finds nothing is announced like any count.
+   */
+  noResults: string
+  /** Title when a new first page failed and the previous rows stay on screen. */
+  refreshFailed: string
+  /** The line under {@link ListFooterMessages.refreshFailed}: what you see and can do. */
+  refreshFailedHint: string
+  /** Title when loading the next page failed. */
+  loadMoreFailed: string
+  /** The line under {@link ListFooterMessages.loadMoreFailed}: what you see and can do. */
+  loadMoreFailedHint: string
+}
+
+/** Strings of `FilterBar`. */
+export interface FilterBarMessages {
+  /** Placeholder of the search input. */
+  searchPlaceholder: string
+  /** Accessible name of the search input (a placeholder is no label). */
+  searchLabel: string
+  /** Accessible name of the chip group. */
+  chipsLabel: string
+}
+
+/** Strings of the widget renderer's fallbacks. */
+export interface RendererMessages {
+  /** A layout cell names a widget id the bundle does not contain. */
+  widgetUnavailable: string
+  /** A widget threw while rendering. */
+  widgetCrashed: string
+  /** Builder canvas/preview: the cell has no data yet. */
+  noDataYet: string
+}
+
+/** Strings of the visual view builder (`LayoutBuilder`). */
+export interface BuilderMessages {
+  title: string
+  builderBadge: string
+  previewBadge: string
+  catalogue: string
+  /** Toolbar button that opens the save dialog: saves the draft as a dashboard. */
+  save: string
+  /**
+   * @deprecated Since 2.8 the builder's commit button is Apply
+   * ({@link BuilderMessages.apply}). An override of `done`, in the builder's
+   * `labels` or a `LocaleProvider`'s `toolkitMessages`, still labels it unless
+   * the same override sets `apply`.
+   */
+  done: string
+  /** Primary action: show the edited view in place and leave the builder (saves nothing). */
+  apply: string
+  /** Tooltip of {@link BuilderMessages.apply}: what it does, and that it saves nothing. */
+  applyHint: string
+  /** Leave the builder without the edits: the view stays as it was before editing. */
+  discard: string
+  /** Tooltip of {@link BuilderMessages.discard}. */
+  discardHint: string
+  /**
+   * Tooltip of {@link BuilderMessages.discard} in a builder without a view to
+   * apply to (no `onExit`): Discard resets the draft in place.
+   */
+  discardHintStandalone: string
+  /** Tooltip of {@link BuilderMessages.save}: what a dashboard is for. */
+  saveHint: string
+  /**
+   * Marker next to the title while the draft has changes that would be lost:
+   * neither the view before editing nor a saved dashboard holds them.
+   */
+  unsavedChanges: string
+  /** Title of the confirmation before unsaved changes are discarded. */
+  discardDialogTitle: string
+  /** What discarding does to the view, when no saved dashboard holds the changes. */
+  discardDialogDescription: string
+  /** What discarding does to the view, when a saved dashboard holds the changes. */
+  discardDialogDescriptionSaved: string
+  /** Safe choice of the discard confirmation (it keeps the draft). */
+  keepEditing: string
+  /** Destructive choice of the discard confirmation. */
+  discardConfirm: string
+  /** Toggle that shows the technical parts: data sources, catalogue, ids. */
+  advanced: string
+  /** Tooltip of {@link BuilderMessages.advanced}: what it shows. */
+  advancedHint: string
+  /** Accessible name of a tab's rename button, with the tab's label. */
+  renameTabNamed: (label: string) => string
+  /** Accessible name of a tab's remove button, with the tab's label. */
+  removeTabNamed: (label: string) => string
+  /** Marks the row that receives the next element added from the list. */
+  rowTarget: string
+  /** Lead word of a step's output line ("provides …"), next to {@link BuilderMessages.catalogueNeedsKeys}. */
+  stepProvides: string
+  /** Accessible name of a key's value field, with the key name (or none yet). */
+  keyValueFor: (key: string) => string
+  viewLayoutTab: string
+  viewPipelineTab: string
+  viewPreviewTab: string
+  saveDialogTitle: string
+  /** What the save dialog does, and that Apply (not Save) changes the view. */
+  saveDialogDescription: string
+  /**
+   * {@link BuilderMessages.saveDialogDescription} in a builder without a view
+   * to apply to (no `onExit`): no Apply to point to.
+   */
+  saveDialogDescriptionStandalone: string
+  saveNameLabel: string
+  saveDescriptionLabel: string
+  saveConfirm: string
+  cancel: string
+  pipelineHeader: string
+  keysHeader: string
+  stepsHeader: string
+  keyName: string
+  keyValue: string
+  stepContextId: string
+  stepPickerLabel: string
+  addKey: string
+  addStep: string
+  emptyKeys: string
+  emptySteps: string
+  statusUpToDate: string
+  statusPending: string
+  statusRefreshing: string
+  paletteHeader: string
+  /** Status line of the palette while the first catalogue answer is on its way. */
+  paletteLoading: string
+  /** The palette has no element (the catalogue answered with none). */
+  paletteEmpty: string
+  canvasEmpty: string
+  canvasDropHint: string
+  addRow: string
+  addTab: string
+  removeRow: string
+  renameTab: string
+  removeTab: string
+  tabsLabel: string
+  catalogueDescription: string
+  catalogueKeys: string
+  catalogueSteps: string
+  catalogueUnreachable: string
+  catalogueUnreachableEmpty: string
+  catalogueProducedBy: string
+  catalogueConsumedBy: string
+  catalogueNeedsKeys: string
+  cataloguePickKey: string
+  catalogueAddProducingStep: string
+  catalogueLive: string
+  catalogueMissing: string
+  /** Title of the error state when the catalogue fetch fails (the raw reason goes under Details). */
+  catalogueError: string
+  /** What to do when the catalogue fetch fails (the state offers a retry). */
+  catalogueErrorHint: string
+  /** Heading for the pipeline-validation warning banner. */
+  validationWarning: string
+  /** Title of the save dialog's error state when a save fails (the raw reason goes under Details). */
+  saveError: string
+  /** What to do when a save fails (the dialog's Save button is the retry). */
+  saveErrorHint: string
+  /** Inline message when a tab rename is rejected (duplicate label). */
+  renameDuplicate: string
+  /** Toolbar stat: keys present in the live context. */
+  statsLive: string
+  /** Toolbar stat: widgets the current keys and steps can feed. */
+  statsReachable: string
+  /** Toolbar stat: widgets nothing can feed yet. */
+  statsUnreachable: string
+  /** Empty layout view: title. */
+  emptyHintTitle: string
+  /** Empty layout view: what to do. */
+  emptyHintBody: string
+  /** Empty layout view: button that switches to the data-sources tab. */
+  openDataSources: string
+  saveNamePlaceholder: string
+  saveDescriptionPlaceholder: string
+  /** Toast after a successful save. */
+  saved: (name: string) => string
+  /** Hint next to the tab strip. */
+  renameHint: string
+  /** Tooltip of a tab trigger. */
+  renameTitle: string
+  /** Note next to the data-sources header. */
+  autoApplies: string
+  noMoreKeys: string
+  /** Tooltip of the detected value type next to a key value. */
+  parsedType: string
+  /** Name of a detected value type (`valueTypeLabel` code: str, num, bool, arr, obj, null). */
+  valueType: (code: string) => string
+  removeKey: string
+  removeStep: string
+  noInputs: string
+  noOutputs: string
+  rowLabel: (index: number) => string
+  elementCount: (count: number) => string
+  moveRowUp: string
+  moveRowDown: string
+  columnSpan: string
+  configureElement: string
+  configureElementSet: (count: number) => string
+  removeElement: string
+  resizeElement: string
+  noKeysRegistered: string
+  noStepsRegistered: string
+  /** Prefix for "used by" lines that list steps. */
+  catalogueStepPrefix: string
+  /** Prefix for "used by" lines that list widgets. */
+  catalogueElementPrefix: string
+}
+
+/** Strings of the builder's per-cell props sheet. */
+export interface PropsSheetMessages {
+  title: string
+  description: string
+  apply: string
+  cancel: string
+  reset: string
+  noProps: string
+  unsetOption: string
+  unsupportedType: (type: string) => string
+}
+
+/** One locale's complete toolkit catalog. */
+export interface ToolkitMessages {
+  common: CommonMessages
+  view: ViewMessages
+  listFooter: ListFooterMessages
+  filterBar: FilterBarMessages
+  pills: { live: string }
+  renderer: RendererMessages
+  builder: BuilderMessages
+  propsSheet: PropsSheetMessages
+}

package/src/locale/messages-de.ts

@@ -0,0 +1,198 @@
+import type { ToolkitMessages } from "./message-types.js"
+
+/**
+ * German catalog. du-Ansprache, aktive Sätze, normale Groß- und
+ * Kleinschreibung, „…“ als Auslassung, kein Gedankenstrich als Verbinder.
+ * Fehlertexte sagen, was passiert ist und was du tun kannst. Guarded by
+ * `toolkit-messages.test.ts`.
+ */
+export const de: ToolkitMessages = {
+  common: {
+    close: "Schließen",
+    retry: "Erneut versuchen",
+    details: "Details",
+    dismiss: "Hinweis schließen",
+    notifications: "Hinweise",
+    loadFailed: "Der Inhalt konnte nicht geladen werden",
+    loadFailedHint: "Versuch es noch mal. Klappt es wieder nicht, frag im Chat nach.",
+  },
+  view: {
+    loading: "Ansicht wird geladen…",
+    cancelled: "Abgebrochen. Frag im Chat noch mal nach dieser Ansicht.",
+    refresh: "Aktualisieren",
+    refreshing: "Wird aktualisiert…",
+    enterFullscreen: "Vollbild",
+    exitFullscreen: "Vollbild verlassen",
+    build: "Ansicht bearbeiten",
+    slowHint: "Das dauert länger als üblich. Wenn nichts passiert, frag im Chat noch mal nach.",
+    errorTitle: "Die Ansicht konnte nicht geladen werden",
+    errorHint: "Versuch es noch mal. Klappt es wieder nicht, frag im Chat nach.",
+    errorHintNoRetry: "Frag im Chat noch mal nach dieser Ansicht.",
+    retry: "Erneut versuchen",
+    blockedTitle: "Der Chat hat das Ergebnis nicht an die Ansicht weitergegeben",
+    blockedHint: "Lade die Ansicht selbst oder frag im Chat nach dem aktuellen Stand.",
+    blockedHintNoRetry:
+      "Die Aktion ist schon gelaufen, deshalb startet die Ansicht sie nicht noch mal. Frag im Chat nach dem aktuellen Stand.",
+    blockedRetry: "Ansicht laden",
+    errorDetails: "Details",
+    stepErrorsTitle: "Ein Teil der Daten konnte nicht geladen werden",
+    stepErrorsHint: "Versuch es noch mal, um die fehlenden Daten zu laden.",
+    refreshFailed: "Aktualisieren hat nicht geklappt.",
+    refreshFailedHint: "Du siehst den zuletzt geladenen Stand. Versuch es gleich noch mal.",
+    fullscreenFailed: "Die Darstellung ließ sich nicht umschalten.",
+    fullscreenFailedHint: "Die Ansicht bleibt, wie sie ist. Versuch es gleich noch mal.",
+    dataAsOf: (time) => `Neu geladen um ${time} Uhr`,
+  },
+  listFooter: {
+    showing: ({ shown, total, noun }) => `Zeigt ${shown} von ${total} ${noun}`.trimEnd(),
+    defaultNoun: "Zeilen",
+    loadMore: "Mehr laden",
+    loadingMore: "Wird geladen…",
+    updating: "Wird aktualisiert…",
+    noResults: "Keine Einträge",
+    refreshFailed: "Die Liste konnte nicht aktualisiert werden",
+    refreshFailedHint: "Du siehst das vorherige Ergebnis. Versuch es gleich noch mal.",
+    loadMoreFailed: "Weitere Einträge konnten nicht geladen werden",
+    loadMoreFailedHint: "Die Einträge oben sind aktuell. Versuch es gleich noch mal.",
+  },
+  filterBar: { searchPlaceholder: "Filtern…", searchLabel: "Filtern", chipsLabel: "Filter" },
+  pills: { live: "Live" },
+  renderer: {
+    widgetUnavailable: "Dieses Element ist in dieser Version nicht verfügbar.",
+    widgetCrashed: "Dieses Element konnte nicht angezeigt werden.",
+    noDataYet: "Noch keine Daten. Nach dem nächsten Aktualisieren sind sie da.",
+  },
+  builder: {
+    title: "Ansicht bearbeiten",
+    builderBadge: "Bearbeitung",
+    previewBadge: "Vorschau",
+    catalogue: "Katalog",
+    save: "Als Dashboard speichern",
+    done: "Fertig",
+    apply: "Übernehmen",
+    applyHint: "Zeigt deine Änderungen in dieser Ansicht und speichert nichts.",
+    discard: "Verwerfen",
+    discardHint: "Beendet die Bearbeitung. Die Ansicht bleibt, wie sie war.",
+    discardHintStandalone: "Setzt deine Änderungen zurück.",
+    saveHint: "Speichert das Layout als Dashboard, das du später wieder öffnen kannst.",
+    unsavedChanges: "Ungespeicherte Änderungen",
+    discardDialogTitle: "Änderungen verwerfen?",
+    discardDialogDescription:
+      "Deine Änderungen an dieser Ansicht gehen verloren. Die Ansicht bleibt, wie sie vor dem Bearbeiten war.",
+    discardDialogDescriptionSaved:
+      "Die Ansicht springt auf den Stand vor dem Bearbeiten zurück. Dein gespeichertes Dashboard behält deine Änderungen.",
+    keepEditing: "Weiter bearbeiten",
+    discardConfirm: "Änderungen verwerfen",
+    advanced: "Erweitert",
+    advancedHint: "Zeigt Datenquellen, Katalog und technische IDs.",
+    renameTabNamed: (label) => `Tab „${label}“ umbenennen`,
+    removeTabNamed: (label) => `Tab „${label}“ entfernen`,
+    rowTarget: "Neue Elemente landen hier",
+    stepProvides: "liefert",
+    keyValueFor: (key) => (key ? `Wert von ${key}` : "Wert"),
+    viewLayoutTab: "Layout",
+    viewPipelineTab: "Datenquellen",
+    viewPreviewTab: "Vorschau",
+    saveDialogTitle: "Als Dashboard speichern",
+    saveDialogDescription:
+      "Speichert das Layout mit seinen Datenquellen als Dashboard, das du später wieder öffnen kannst. Diese Ansicht änderst du mit „Übernehmen“.",
+    saveDialogDescriptionStandalone:
+      "Speichert das Layout mit seinen Datenquellen als Dashboard, das du später wieder öffnen kannst.",
+    saveNameLabel: "Name",
+    saveDescriptionLabel: "Beschreibung",
+    saveConfirm: "Dashboard speichern",
+    cancel: "Abbrechen",
+    pipelineHeader: "Datenquellen",
+    keysHeader: "Schlüssel",
+    stepsHeader: "Schritte",
+    keyName: "Schlüssel",
+    keyValue: 'Wert, "Text", true, {…}',
+    stepContextId: "Schritt-ID",
+    stepPickerLabel: "Schritt wählen",
+    addKey: "Schlüssel hinzufügen",
+    addStep: "Schritt hinzufügen",
+    emptyKeys: "Noch keine Schlüssel.",
+    emptySteps: "Noch keine Schritte.",
+    statusUpToDate: "Aktuell",
+    statusPending: "Wird gleich aktualisiert…",
+    statusRefreshing: "Wird aktualisiert…",
+    paletteHeader: "Elemente",
+    paletteLoading: "Elemente werden geladen…",
+    paletteEmpty: "Noch keine Elemente verfügbar. Elemente erscheinen, sobald ihre Daten da sind.",
+    canvasEmpty: "Zieh ein Element hierher oder klick eins in der Liste an.",
+    canvasDropHint: "Zum Hinzufügen loslassen",
+    addRow: "Zeile hinzufügen",
+    addTab: "Tab hinzufügen",
+    removeRow: "Zeile entfernen",
+    renameTab: "Tab umbenennen",
+    removeTab: "Tab entfernen",
+    tabsLabel: "Tabs",
+    catalogueDescription:
+      "Alle Schlüssel und Elemente, die der Server kennt, ob gerade verfügbar oder nicht.",
+    catalogueKeys: "Schlüssel",
+    catalogueSteps: "Schritte",
+    catalogueUnreachable: "Nicht verfügbare Elemente",
+    catalogueUnreachableEmpty: "Alle Elemente sind verfügbar.",
+    catalogueProducedBy: "erzeugt von",
+    catalogueConsumedBy: "genutzt von",
+    catalogueNeedsKeys: "braucht",
+    cataloguePickKey: "Als Schlüssel hinzufügen",
+    catalogueAddProducingStep: "Erzeugenden Schritt hinzufügen",
+    catalogueLive: "vorhanden",
+    catalogueMissing: "fehlt",
+    catalogueError: "Der Katalog ließ sich nicht aktualisieren",
+    catalogueErrorHint:
+      "Die angezeigten Elemente und Datenquellen sind vielleicht nicht aktuell. Versuch es noch mal. Klappt es wieder nicht, frag im Chat nach.",
+    validationWarning: "So lässt sich die Ansicht nicht darstellen",
+    saveError: "Das Dashboard ließ sich nicht speichern",
+    saveErrorHint:
+      "Deine Änderungen sind noch da. Versuch gleich noch mal zu speichern. Klappt es wieder nicht, frag im Chat nach.",
+    renameDuplicate: "Einen Tab mit diesem Namen gibt es schon.",
+    statsLive: "vorhanden",
+    statsReachable: "verfügbar",
+    statsUnreachable: "nicht verfügbar",
+    emptyHintTitle: "Noch keine Elemente verfügbar.",
+    emptyHintBody:
+      "Füg unter Datenquellen einen Schlüssel oder einen Schritt hinzu. Elemente erscheinen, sobald ihre Daten da sind.",
+    openDataSources: "Datenquellen öffnen",
+    saveNamePlaceholder: "Name des Dashboards",
+    saveDescriptionPlaceholder: "Optional",
+    saved: (name) => `Dashboard „${name}“ gespeichert.`,
+    renameHint: "Einen Tab benennst du mit F2, per Doppelklick oder über den Stift um.",
+    renameTitle: "F2 oder Doppelklick zum Umbenennen",
+    autoApplies: "Änderungen erscheinen sofort in der Vorschau",
+    noMoreKeys: "Keine weiteren Schlüssel verfügbar.",
+    parsedType: "Erkannter Typ",
+    valueType: (code) =>
+      ({ str: "Text", num: "Zahl", bool: "Ja/Nein", arr: "Liste", obj: "Objekt", null: "leer" })[
+        code
+      ] ?? code,
+    removeKey: "Schlüssel entfernen",
+    removeStep: "Schritt entfernen",
+    noInputs: "keine Eingaben",
+    noOutputs: "keine Ausgaben",
+    rowLabel: (index) => `Zeile ${index}`,
+    elementCount: (count) => (count === 1 ? "1 Element" : `${count} Elemente`),
+    moveRowUp: "Zeile nach oben schieben",
+    moveRowDown: "Zeile nach unten schieben",
+    columnSpan: "Spaltenbreite",
+    configureElement: "Element konfigurieren",
+    configureElementSet: (count) => `Element konfigurieren (${count} gesetzt)`,
+    removeElement: "Element entfernen",
+    resizeElement: "Elementbreite ändern",
+    noKeysRegistered: "Keine Schlüssel registriert.",
+    noStepsRegistered: "Keine Schritte registriert.",
+    catalogueStepPrefix: "Schritt",
+    catalogueElementPrefix: "Element",
+  },
+  propsSheet: {
+    title: "Element konfigurieren",
+    description: "Einstellungen für dieses Element.",
+    apply: "Übernehmen",
+    cancel: "Abbrechen",
+    reset: "Zurücksetzen",
+    noProps: "Dieses Element hat keine Einstellungen.",
+    unsetOption: "Nicht gesetzt",
+    unsupportedType: (type) => `Diesen Feldtyp (${type}) kannst du hier nicht bearbeiten.`,
+  },
+}