Skip to content

Latest commit

 

History

History
873 lines (732 loc) · 46.1 KB

CHANGELOG.md

File metadata and controls

873 lines (732 loc) · 46.1 KB

Changelog

Format nach Keep a Changelog, ein Abschnitt pro Paket-Release (Tag <paket>/vX.Y.Z). Jeder Eintrag nennt, was sich ändert und was ein konsumierendes Tool beim Upgrade tun muss („Migration“) — dieses Changelog ist die Upgrade-Anleitung für die Tools.

[Unreleased]

Doku für die Tools (kein Release)

  • Upgrade-Leitfaden Vite 8, React 19, Django 6.1 und Tailwind 4: Reihenfolge, Stolperfallen mit Fehlermeldung und Lösung, Prüfschritte (Erfahrungen aus abstimmbar und ausleihbar). Kein Paket-Release nötig: @basicbar/ui und die Django-Pakete laufen unverändert unter dem neuen Stack.

Template und @basicbar/ui-README (kein Release)

  • Neue Konvention „Kopfzeile: Anmelden und Kontomenü“ im README von @basicbar/ui: Reihenfolge und Aussehen der Kopfzeile für Gäste und Angemeldete, Aufbau des Kontomenüs (inkl. Tastatur und Telefon) und der Startkarte für Gäste. Bisher sah das in jedem Tool etwas anders aus.
  • Gerüst: frontend/src/components/UserMenu.tsx (neu) und die Kopfzeile in App.tsx folgen der Konvention (statt LogIn/LogOut-Icons und dauerhaftem PreferencesMenu); CLAUDE.md verweist darauf.
  • Migration (bestehende Tools, freiwillig): Kopfzeile und Kontomenü an die Konvention angleichen. CLAUDE.md übernimmt copier update nicht (_skip_if_exists); die Regel bei Bedarf von Hand ergänzen.

Repo

  • Dependabot-Version-Updates eingeschaltet (.github/dependabot.yml): wöchentlich, gruppiert, für GitHub Actions und @basicbar/ui (npm, TipTap immer gemeinsam). Die Django-Pakete bleiben bewusst draußen, damit ihre Untergrenzen nicht steigen. Die CI testet jeden Dependabot-PR. Für die Tools ändert sich nichts.

@basicbar/ui (→ wird ui/v0.11.1)

Fix: Link-Dialog verlor die Textauswahl. Seit dem eigenen URL-Dialog (0.11.0) war die Auswahl nach dem Schließen des Dialogs in Firefox (und in Chromium nach Doppelklick-Auswahl) auf den Textanfang zusammengefallen — der Link wurde dann nirgends gesetzt bzw. nicht entfernt. RichTextEditor merkt sich jetzt die Auswahl vor dem Dialog (und führt sie über zwischenzeitliche Änderungen, z. B. einen fertigen Upload, nach) und stellt sie vor setLink/unsetLink wieder her. Die Bildbeschreibung (Bearbeiten-Modus) war nicht betroffen: Sie folgt der Position des Bildknotens, nicht der Auswahl.

Migration: keine; nur die Version auf ui/v0.11.1 heben.

@basicbar/ui (ui/v0.11.0, veröffentlicht 2026-11-19)

RichTextEditor ohne Browser-Dialoge; neuer Hook onImageInserted. Alt-Text- und Link-Abfrage laufen über einen eigenen modalen Dialog (natives <dialog>, beschriftetes Eingabefeld, Enter = OK, Esc = Abbrechen, Fokus zurück in den Editor) statt window.prompt; ein gescheiterter Upload erscheint als schließbarer Hinweis unter der Toolbar (role="alert") statt per window.alert. Ein hochgeladenes Bild wird sofort mit alt="" eingefügt und erst danach beschrieben — Abbrechen verliert also kein Bild, und bei zwei schnell hintereinander hochgeladenen Bildern landet jede Beschreibung auf ihrem eigenen Bild (die Dialoge laufen nacheinander). Neue optionale Prop onImageInserted({ src, alt, mode, file }) → Promise<{ alt } | null>: Damit zeigt das Tool einen eigenen Bild-Dialog, nach dem Upload (mode: "insert") und beim Button „Bildbeschreibung“ (mode: "edit"); Details im README („Rich text“).

Migration: neue Übersetzungs-Keys "OK", "Cancel" und "Dismiss" im Katalog des Tools ergänzen (de: „OK“, „Abbrechen“, „Schließen“). onImageInserted ist optional; ohne die Prop verhält sich der Editor wie bisher, nur mit dem eingebauten Dialog statt der Browser-Abfrage.

@basicbar/ui (ui/v0.10.0, veröffentlicht 2026-11-16)

Neu: SegmentedControl — Auswahl „eins aus wenigen“ als Pill mit gleich breiten Segmenten und gleitendem Daumen (Klick, Tastatur, Ziehen mit Finger/Maus; rastet beim Loslassen ein), herausgelöst aus abstimmbar (components/ui.tsx). Optisch klar von An/Aus-Filter-Pills unterschieden. Neu gegenüber abstimmbar: role="radiogroup" statt group (die Segmente sind role="radio"), size="md" für 44-px-Touch-Ziele, sichtbarer Fokusring, transition-transform für den Daumen (abgeschaltet bei prefers-reduced-motion).

Migration: Tarball auf ui/v0.10.0, Vite-Dep-Cache leeren. abstimmbar kann die eigene Kopie in components/ui.tsx löschen und import { SegmentedControl, type SegOption } from "@basicbar/ui" nutzen (Props unverändert, size ist optional). Die Tailwind-content-Zeile für node_modules/@basicbar/ui/dist muss vorhanden sein (ist es in allen Tools).

basicbar-pdf (→ wird pdf/v0.1.0)

Neues Paket: gemeinsamer PDF-Rahmen für herunterladbare Dokumente, herausgelöst aus abstimmbar (common/pdf.py, Sitzungsprotokoll) und um das erweitert, was kalkulierbar für seine Berichte braucht: A4 quer (landscape=True), Ränder (margin_mm), Autor, Tabellen mit col_widths="auto", rechtsbündigen Zahlenspalten (align_right_from) und fetten Summenzeilen (strong_rows). Mitgeliefert wird Plus Jakarta Sans (OFL). Abhängigkeit: reportlab>=4.4,<6 (getestet mit 4.4.4 und 5.1.0), kein Django.

Migration (abstimmbar): common/pdf.py und common/fonts/ löschen, from basicbar_pdf import PdfDocument, dazu page_label=gettext_lazy("Page %(page)s of %(pages)s") und image_placeholder=gettext_lazy("[Image]") übergeben (die msgids stehen schon im Katalog). Migration (kalkulierbar): report_render.render_pdf auf PdfDocument(landscape=True, margin_mm=15) umstellen; die Schrift wechselt dabei von Helvetica zu Plus Jakarta Sans.

basicbar-integrations (→ wird integrations/v0.5.0)

ai.chat_json kann Bilder senden und das Modell überschreiben. Neue optionale Keyword-Argumente: images=[(bytes, mime), …] hängt die Bilder als image_url-Teile (Data-URL, base64) an die User-Nachricht an (für Vision-Modelle; das Verkleinern übernimmt der Aufrufer), und model="…" ersetzt AI_MODEL nur für diesen Aufruf (z. B. ein eigenes Vision-Modell). Ohne images bleibt die Nachricht ein einfacher String, bestehende Aufrufe ändern sich nicht.

Migration: keine nötig; Tarball/Tag auf integrations/v0.5.0 heben, wenn das Tool die neuen Argumente nutzen will.

basicbar-integrations (→ wird integrations/v0.4.0)

Neues Modul metrics: token-geschützter Prometheus-Endpunkt. MetricsView (DRF-APIView, nur GET/HEAD) rendert Gauges im Prometheus-Textformat 0.0.4, ohne zusätzliche Abhängigkeit. Das Tool leitet ab, implementiert collect(gauges) und hängt den View selbst ein (außerhalb von /api/, das Paket registriert keine URL). Neues Setting METRICS_TOKEN (Default ""): leer → 404; sonst nur mit exakt Authorization: Bearer <token>, sonst 401 mit WWW-Authenticate: Bearer. Antworten tragen Cache-Control: no-store; Accept wird ignoriert (kein 406), Default- Throttles des Projekts greifen nicht. Das Token muss ASCII sein. Gauges.gauge(...) escaped Label-Werte und weist ungültige Namen sowie doppelte Familien und Label-Sets mit ValueError ab. Details im README („Prometheus-Metriken“).

Migration: nur Version heben; Metriken sind opt-in über METRICS_TOKEN. Wer sie nutzt: Subclass + URL anlegen, METRICS_TOKEN in beiden Compose-Dateien durchreichen und /metrics im Caddyfile an app:8000 weiterleiten.

basicbar-auth (→ wird auth/v0.2.2)

Username-Fallback übernimmt keine lokalen oder LTI-Konten mehr (Security- Review Abstimmbar). Mit OIDC_MATCH_BY_USERNAME_FALLBACK=True konnte ein IdP-Login ein lokales Break-Glass-Konto (createsuperuser, kein Subject) oder ein LTI-natives Konto (lti:<platform>:<sub>) mit gleichem Usernamen übernehmen — samt Superuser-Rechten. Der Fallback matcht jetzt nur Konten mit vorhandenem, nicht-lti:-Subject (Subject-Drift nach Realm-Reimport funktioniert unverändert). Jede Übernahme wird als WARNING mit Username sowie altem und neuem Subject protokolliert. Kollidiert der Username mit einem solchen Konto, verweigert create_user sauber mit PermissionDenied (Fehler- Redirect statt 500, WARNING-Log); das bestehende Konto bleibt unberührt. Die Kollisionsprüfung auf dem Create-Pfad ist case-insensitiv (username__iexact): eine IdP-Identität „Frank“ wird abgewiesen, wenn lokal „frank“ existiert — bewusste Verhaltensänderung, unabhängig vom Fallback-Flag.

Migration: Version heben. Wer sich bewusst auf die Übernahme lokaler Konten verlassen hat, muss diesen Account einmalig manuell mit dem OIDC-Subject versehen.

@basicbar/ui (→ wird ui/v0.9.1)

RichTextEditor verwirft keine Eingaben mehr durch veraltete Echos. Der Editor glich seinen value per Effekt ab und rief bei jeder Abweichung vom aktuellen Editor-HTML setContent auf. Die eigenen Änderungen kommen aber einen Render später als value zurück — unter Last (asynchrone State-/Autosave-Runden) tippt man dazwischen weiter, das Echo ist dann schon veraltet und setzte den Editor auf den älteren Text zurück: das neueste Zeichen ging verloren, ein Leerzeichen am Ende endgültig (ProseMirror entfernt es beim Parsen). Der Editor merkt sich jetzt seine eigenen onChange-Werte und ignoriert deren Echos (aktuell wie veraltet). Echte Änderungen von außen werden weiter übernommen — auch eine, die einem früheren Wert gleicht (z. B. Formular-Reset auf "", Wechsel zu einer Frage mit identischem Text).

Migration: Tarball auf ui/v0.9.1, Vite-Dep-Cache leeren. Eigene Echo-Wrapper um den Editor (abstimmbar: RichTextInput in TranslatableField.tsx) können entfallen.

Template

Caddyfile leitet an den Dienst app weiter: Caddyfile.jinja schickte /api/*, /admin/* und /oidc/* an backend:8000. In docker-compose.prod.yml heißt der Django-Dienst aber app, einen Dienst backend gibt es dort nicht. Caddy konnte den Upstream deshalb nicht auflösen: API, Login und Django-Admin waren in Produktion nicht erreichbar, nur die SPA wurde ausgeliefert. Das Template verwendet jetzt app:8000.

Migration (bestehende Tools): Das Caddyfile gehört dem Tool (_skip_if_exists), copier update ändert es also nicht. Im eigenen Caddyfile jedes reverse_proxy backend:8000 durch reverse_proxy app:8000 ersetzen, sofern der Prod-Dienst app heißt. Bereits umgestellt: kalkulierbar, ansehbar. Nicht betroffen: ausleihbar (älteres Gerüst, dessen Prod-Dienst heißt weiterhin backend).

App-spezifische Cookie-Namen für Session und CSRF (#22): Browser trennen Cookies pro Host, nicht pro Port. Tools, die parallel auf demselben Host laufen (in der Entwicklung mehrere „-bar“-Tools auf localhost), überschrieben sich gegenseitig sessionid/csrftoken – man war in den anderen Tools abgemeldet (403 "Anmeldedaten fehlen.") und POSTs scheiterten an CSRF. Das Template setzt jetzt SESSION_COOKIE_NAME = "<project_slug>_sessionid" und CSRF_COOKIE_NAME = "<project_slug>_csrftoken". basicbar-auth (Silent Login, Back-Channel-Logout, whoami mit CSRF-Token) und basicbar-lti setzen keine festen Cookie-Namen voraus; das Template-Frontend liest den CSRF-Token aus whoami, nicht aus dem Cookie.

Migration (bestehende Tools): in backend/config/settings.py die zwei Zeilen ergänzen (Slug des Tools einsetzen). Wer das CSRF-Cookie im Frontend selbst per Namen liest (z. B. getCookie("csrftoken")), stellt auf den neuen Namen oder auf den Token aus whoami um. Beim Deploy werden alle Nutzenden einmal abgemeldet (per Silent-SSO meist sofort wieder angemeldet). Bereits übernommen: ausleihbar (virtUOS/ausleihbar#105), kalkulierbar.

basicbar-integrations (→ wird integrations/v0.3.0)

CapabilitiesView entfernt (Framework-Review: kein Tool hat GET /api/capabilities/ je aufgerufen — alle vier mischen die Flags in ihr whoami). An seine Stelle tritt capabilities.capabilities_payload() mit genau den drei Schlüsseln, die die Tools heute von Hand zusammensetzen (ai_enabled, content_default_language, content_translation_enabled). basicbar_integrations.urls enthält nur noch translate/.

Migration: Version heben. Wer basicbar_integrations.urls einbindet, verliert den unbenutzten Endpunkt — sonst nichts. Empfohlen: in accounts/views.py whoami als {**whoami_payload(request), **capabilities_payload(), …} schreiben und die drei Inline-Flags löschen.

Alle Django-Pakete (→ werden auth/v0.2.1, lti/v0.1.5, integrations/v0.3.0)

__version__ kommt aus den Paket-Metadaten (importlib.metadata) statt aus einem zweiten handgepflegten String — die Versionen drifteten im Review auseinander. Ein nicht installierter Checkout meldet 0.0.0.dev0. Keine Migration.

Repo

  • CHANGELOG: alle Releases seit Juli standen unter „[Unreleased] (→ wird …)“, obwohl längst getaggt — jetzt je ein datierter Abschnitt pro Tag.
  • README: die Paket-Tabelle nennt keine Versionsnummern mehr (sie waren vom Juli); aktuelle Stände stehen in den Tags und hier.
  • Doku-Drift zum Capabilities-Endpunkt in CLAUDE.md und EXTRAKTIONSPLAN bereinigt.

ui/v0.9.0 — 2026-10-11

@basicbar/ui

Anlass: abstimmbar #178 (Kontrast) brauchte einen Formularfeld-Rahmen mit ≥ 3:1 (WCAG 1.4.11) und Fehlertext mit ≥ 4.5:1 und überschrieb dafür per CSS den Rahmen des Paket-Editors. Beides wird jetzt Paket-Funktion.

  • Neue semantische Farben field und danger im Preset (mit / <alpha-value>, also z. B. border-field/50, text-danger). Sie lesen die CSS-Variablen --bb-field-border und --bb-danger (OKLCH-Kanäle ohne oklch()), deren Defaults base.css setzt (hell unter :root, dunkel unter :root.dark). Defaults und berechnete Kontraste stehen als Kommentar in base.css: field hell 0.6 0 0 (3.5–3.95:1 auf Weiß/slate-50/100), dunkel 0.56 0 0 (≥ 3.76:1 auf slate-900/950); danger hell 0.55 0.235 27 (≥ 4.74:1), dunkel 0.704 0.191 22.216 = red-400 (≥ 5.03:1).
  • Komponenten nutzen die Tokens: Rahmen von RichTextEditor (Fokusring unverändert) und Standard-Input von TranslatableField → border-field (sichtbar etwas dunkler als vorher); Pflicht-Sternchen, Übersetzungsfehler und „Pflichtfeld“-Meldung in TranslatableField sowie die Fehlermeldung der Übersetzungsleiste → text-danger (vorher rose-500/600/400).
  • Preset-Kommentar korrigiert: „slate-400 ≥ 4.5:1 auf Weiß“ galt nicht für jede Rampe. Gedämpfter Text ist in beiden Themes gegen Seite und Karten auf ≥ 4.5:1 zu prüfen.

Tönen: Die Defaults sind neutral. Ein Tool färbt sie ein, indem es die Variablen in seinem eigenen (ungeschichteten) CSS überschreibt, z. B.

:root { --bb-field-border: 0.62 0.011 220; --bb-danger: 0.55 0.235 27; }
:root.dark { --bb-field-border: 0.56 0.011 220; }

und die Kontraste (field ≥ 3:1, danger ≥ 4.5:1) gegen die eigenen Hintergründe nachrechnet.

Migration:

  1. Tarball auf ui/v0.9.0, Vite-Dep-Cache leeren.
  2. Eigene Overrides des Editor-Rahmens (z. B. .xy-rte > div.rounded-lg { border-color: … }) entfernen; stattdessen --bb-field-border setzen, falls der Default nicht passt. Eine lokale field-Farbe im Tool-Preset durch die Variable ersetzen.
  3. Optional: lokale Fehlerrot-Muster (text-red-600 dark:text-red-400 o. ä.) durch text-danger ersetzen.

ui/v0.8.0 — 2026-10-10

@basicbar/ui

Anlass: Auf Smartphones verdeckte die schwebende Übersetzungsleiste („DE · EN · Alle Felder übersetzen“) Formularinhalte (abstimmbar #179); abstimmbar umging das mit einem verschachtelten Provider und zwei CSS-Overrides auf Paket-Markup. Das wird jetzt Paket-Funktion.

  • Verschiebbare Übersetzungsleiste: Die schwebende Leiste von TranslationFormProvider hat links einen Griff (GripVertical, Name/Tooltip "Move translation controls"). Ziehen mit Maus oder Touch verschiebt die ganze Leiste per CSS-translate (setzt sich mit Tailwind-Transform-Utilities in controlsClassName zusammen) – die Position aus controlsClassName bleibt der Anker. Die Leiste bleibt vollständig im Viewport (auch nach Fenstergrößenänderung); der Versatz wird pro Browser in localStorage (basicbar_translation_controls_offset) gemerkt. Tastatur: Pfeiltasten 16 px, mit Umschalt 64 px; Pos1/Esc oder Doppelklick auf den Griff setzen zurück. Ein bloßer Klick tut nichts. Der Griff erscheint nur, solange die Leiste fixed/absolute positioniert ist. Abschalten: movable={false}.
  • Andockplatz TranslationControlsSlot ({ className?, media? }): ein Platzhalter, den eine Seite dorthin setzt, wo die Leiste im Fluss stehen soll (z. B. oben im Formular). Solange ein Slot gemountet ist und seine Media Query passt (Default "(max-width: 767px)", exportiert als TRANSLATION_SLOT_MEDIA, = unter Tailwind md), rendert der nächste Provider die Leiste per Portal in den Slot – ohne Fixed-Positionierung, Griff und Versatz. Sonst schwebt sie wie bisher; der leere Slot ist per :empty ausgeblendet. Bei mehreren Slots gewinnt der zuletzt gemountete. Neue Provider-Prop slotControlsClassName (Default flex justify-end, also rechtsbündig) für die angedockte Variante; controlsClassName gilt nur für die schwebende.
  • Rich-Text-Toolbar bricht um (flex-wrap) statt horizontal zu scrollen – auf schmalen Screens waren die versteckten Buttons nicht zu erahnen; wo die Zeile passt, ändert sich nichts.
  • Sprach-Tabs von TranslatableField: Trefferfläche per ::after auf ≥ 24 px Höhe (WCAG 2.5.8), Optik unverändert.

Migration:

  1. Tarball auf ui/v0.8.0, Vite-Dep-Cache leeren.
  2. Neuen Übersetzungs-Key "Move translation controls" in den deutschen Katalog aufnehmen (Vorschlag: "Übersetzungsleiste verschieben").
  3. Optional: <TranslationControlsSlot /> oben in Formulare mit übersetzbaren Feldern setzen (innerhalb des TranslationFormProvider), damit die Leiste auf Smartphones im Fluss steht statt Inhalte zu verdecken. Wer die Leiste in Tests über eine Hook-Klasse findet, gibt sie auch in slotControlsClassName mit (z. B. "my-hook flex justify-end"). Workarounds wie ein verschachtelter Provider pro Formular entfallen.
  4. Lokale Overrides für Toolbar-Umbruch oder Tab-Trefferfläche (falls vorhanden) entfernen.
  5. Die schwebende Leiste hat jetzt einen Griff – wer das nicht will: movable={false}.

ui/v0.7.2 — 2026-10-07

@basicbar/ui

Sicherheits-Fix stripHtml / isEmptyHtml (#20): Beide parsten über innerHTML auf einem Element des Live-Dokuments — dort lädt der Browser Bilder und führt Inline-Handler aus, <img src=x onerror=…> lief also, auch ohne Einhängen. Jetzt wird in einem inerten DOMParser-Dokument geparst (nichts wird ausgeführt oder geladen); isEmptyHtml erkennt Bilder über den geparsten Body statt per Regex. Verhalten sonst unverändert.

Migration: Tarball auf ui/v0.7.2. Keine Code-Änderung nötig.

ui/v0.7.1 — 2026-10-02

@basicbar/ui

A11y-Fix TranslatableField (#11): Der hint hatte mit text-slate-400 nur ~2,6:1 Kontrast und war nicht mit dem Feld verknüpft. Jetzt text-slate-600 dark:text-slate-300 (AA), und Hinweis, Veraltet-Hinweis und Pflichtfeld-Fehler hängen per aria-describedby an der Eingabe (Screenreader lesen sie mit dem Feld vor); Veraltet- und Fehlertext ebenfalls auf AA-Kontrast (amber-700, rose-600). renderInput bekommt dafür describedBy, RichTextEditor eine gleichnamige Prop (auch zur Laufzeit aktualisiert).

Migration: Tarball auf ui/v0.7.1. Wer renderInput mit RichTextEditor nutzt, reicht zusätzlich describedBy={describedBy} durch (sonst bleibt der Editor ohne Beschreibung — nichts bricht).

auth/v0.2.0 — 2026-10-01

basicbar-auth

Session-Endpunkte und Routen im Paket (Framework-Review; die vier Tools trugen identische Kopien): basicbar_auth.views mit whoami_payload / whoami, logout_view, set_language; basicbar_auth.urls mit oidc/logout-redirect/, oidc/silent/, oidc/backchannel-logout/, oidc/callback/ (neu: SafeOIDCCallbackView aus abstimmbar — Browser- „Zurück“ nach dem Login landet auf der SPA statt auf einer 400-Seite), mozillas Routen und api/whoami/language/. AbstractBasicUser hat jetzt language (alle Tools hatten das identische Feld).

Admin-Gruppe entzieht nur, was sie verliehen hat. Bisher setzte OIDC_ADMIN_GROUP bei jedem Login is_staff/is_superuser hart auf die Gruppenmitgliedschaft — eine Beförderung in der Nutzerverwaltung des Tools wurde beim nächsten Login still zurückgenommen. Jetzt wird nur entzogen, wenn der Claims-Snapshot des vorigen Logins die Gruppe enthielt.

Session-Index statt Komplett-Scan beim Back-Channel-Logout. Neues Model UserSession (Login-/Logout-Signale), eigene Migration basicbar_auth 0001. Der Scan über alle unabgelaufenen Sessions bleibt nur als Fallback für Sessions aus der Zeit vor dem Upgrade.

Außerdem: discover_endpoints loggt Fehler als WARNING statt still {} zu liefern; filter_users_by_claims spart das exists() ohne aktivierten Fallback.

Migration:

  1. requirements.txt: Tag auth/v0.2.0; python manage.py migrate (legt basicbar_auth_usersession an).
  2. Optional: Tools, die von AbstractBasicUser erben (erkennbar, Template), können ihr eigenes language = CharField(max_length=10, blank=True) aus accounts.User streichen — Django erlaubt das Überschreiben von Feldern abstrakter Basisklassen, es kollidiert also nichts, und die Definition ist identisch (keine DB-Migration, makemigrations --check bleibt leer; gegen erkennbar geprüft). Tools auf AbstractUser (ausleihbar, abstimmbar, modulierbar) ändern nichts.
  3. Empfohlen: config/urls.py auf path("", include("basicbar_auth.urls")) plus eigenes api/whoami/ umstellen und die lokalen logout_view / set_language löschen; whoami als {**whoami_payload(request), …} schreiben (Beispiel im README). abstimmbar: accounts/oidc.py (SafeOIDCCallbackView) und die eigene oidc/callback/-Route entfallen. ausleihbar: SetLanguageView (DRF) kann durch set_language ersetzt werden — gleiche URL, gleiche Antworten.
  4. Admin-Semantik prüfen: Wer sich darauf verlassen hat, dass der IdP- Gruppen-Verlust jede Admin-Rolle entzieht, muss lokale Beförderungen jetzt selbst zurücknehmen (Nutzerverwaltung / Django-Admin).

ui/v0.7.0 — 2026-10-01

@basicbar/ui

TipTap raus aus den Bundles, die keinen Editor rendern (Framework-Review): RichTextEditor liegt jetzt in einem eigenen Entry @basicbar/ui/rich-text-editor; das Paket ist sideEffects: false und wird mit Code-Splitting gebaut. Der Haupt-Entry @basicbar/ui importiert kein @tiptap/* mehr. Nagelprobe am gerenderten Template (kein Editor): Bundle 575 kB → 280 kB (gzip 185 → 91 kB). Die @tiptap/*-Pakete bleiben bewusst dependencies (nicht optionale Peers): sie kosten nur Installationszeit, und die eine Pin-Stelle für alle Tools bleibt erhalten.

Außerdem:

  • stripHtml(html) und isEmptyHtml(html) sind exportiert (abstimmbar hatte vier Kopien). isEmptyHtml zählt ein Editor-Leer-<p></p> als leer, einen reinen Bild-Inhalt aber als gefüllt; TranslatableField mit format="html" nutzt das für seine Ausgefüllt-Punkte (vorher galt ein Bild ohne Text als „nicht übersetzt“).
  • richTextClass (der Prosa-Default von RichText) ist exportiert, damit Aufrufer ihn ergänzen können statt zu kopieren; className ersetzt weiterhin.
  • RichTextEditor hat editable?: boolean (Default true): schreibgeschützt ohne Toolbar und Cursor, Drop/Paste ignoriert; Umschalten zur Laufzeit via setEditable.
  • TranslationFormProvider hat controlsClassName? für die Position der Floating-Controls (Default fixed bottom-6 right-6 z-40) — ersetzt den CSS-Override auf die Utility-Klassen in abstimmbar.
  • renderInput von TranslatableField bekommt onBlur durchgereicht.
  • Performance: TranslatableField berechnet die Sprachreihenfolge und den Ausgefüllt-Status pro Render nur noch einmal (vorher pro Tab/Lookup, bei HTML jeweils mit DOM-Parse); targets im Provider memoisiert.
  • A11y: die Sprach-Tabs tragen den Status („translated“ …) zusätzlich als sr-only-Text (der Punkt war farb-only, WCAG 1.4.1); PreferencesMenu fokussiert beim Öffnen die erste Zeile und unterstützt Pfeiltasten, Home/End (WAI-ARIA-Menü-Pattern), role="menu" hat einen Namen.
  • README: Abschnitt „Übersetzungs-Keys“ mit allen Keys des Pakets.

Migration:

  1. package.json: Tarball auf ui/v0.7.0.
  2. Jeden RichTextEditor-Import auf den neuen Pfad umstellen: import { RichTextEditor } from "@basicbar/ui/rich-text-editor"; (RichText, RichTextEditorProps-Typ: RichText bleibt in @basicbar/ui, der Props-Typ kommt aus dem Editor-Entry). Betroffen: ausleihbar (AdminWelcomePage, AdminPagesPage, AdminPoolsPage), abstimmbar (components/TranslatableField.tsx). Tools ohne Editor (erkennbar, modulierbar) ändern nichts.
  3. Optional, empfohlen: lokale stripHtml-Kopien durch den Export ersetzen (abstimmbar: RoomsPage, ResultsPage, SetPage, QuestionPage — dort !stripHtml(x) && !/<img/.test(x) → isEmptyHtml(x)); abstimmbars .fixed.bottom-6.right-6.z-40-Override in index.css durch controlsClassName="fixed bottom-6 right-6 z-40 max-md:bottom-[5.5rem]" am Provider ersetzen.
  4. Katalog: keine neuen Keys.

lti/v0.1.4 — 2026-10-01

basicbar-lti

Sicherheit: Reflected XSS im LTI-Login behoben. Die 400er-Antworten von lti_login spiegelten iss/client_id aus GET-Parametern in eine HTML-Antwort (Django-Default-Content-Type) — eine präparierte URL konnte so Skript auf der Tool-Origin ausführen. Alle Fehlerantworten des Endpunkts sind jetzt text/plain. Migration: Version heben, sonst nichts.

auth/v0.1.1 — 2026-10-01

basicbar-auth

Sicherheit: Back-Channel-Logout-Tokens werden auf Frische geprüft. Bisher prüfte der Endpunkt nur Signatur, Nonce-Verbot und iss/aud/events/sub — ein einmal abgefangenes Token ließ sich unbegrenzt wiederholen (erzwungener Logout als DoS). Jetzt ist iat Pflicht und darf höchstens OIDC_BACKCHANNEL_MAX_AGE Sekunden alt sein (neues Setting, Default 300); exp wird respektiert. Migration: Version heben; bei stark abweichenden Uhren zwischen IdP und Tool ggf. OIDC_BACKCHANNEL_MAX_AGE erhöhen.

integrations/v0.2.2 — 2026-10-01

basicbar-integrations

  • ai.chat_json und translation_service.translate fangen jetzt alle Transportfehler (ConnectionResetError, IncompleteRead, …) als AIError/TranslationError, statt sie als 500 durchzulassen.
  • HTTP-Fehler tragen den Provider-Body in der Meldung (z. B. „HTTP 400: en is not supported“) statt nur „Bad Request“; LibreTranslate-4xx heißen nicht mehr fälschlich „unavailable“.
  • Nicht-Objekt-JSON vom Übersetzungsdienst ist ein TranslationError.
  • Migration: Version heben; wer str(exc) an Nutzer durchreicht, zeigt jetzt aussagekräftigere Texte.

Template — 2026-10-01

Template (basicbar#13, #14, #17)

  • Pins: basicbar-auth auth/v0.2.0, @basicbar/ui ui/v0.7.0.
  • config/urls.py nutzt include("basicbar_auth.urls") (OIDC-Routen inkl. tolerantem Callback, api/whoami/language/); accounts/views.py enthält nur noch whoami als {**whoami_payload(request), …Feature-Flags} — logout_view/set_language kommen aus dem Paket. accounts.User hat kein eigenes language mehr (geerbt, Migration unverändert).
  • Settings brechen produktiv mit ImproperlyConfigured ab, wenn OIDC_OP_ISSUER gesetzt ist, die Discovery aber keine Endpunkte lieferte (sonst scheitert jeder Login später mit unklarem Fehler).
  • REST_FRAMEWORK.DEFAULT_AUTHENTICATION_CLASSES nur noch SessionAuthentication — DRFs Default aktiviert BasicAuthentication, die mit dem Break-glass-Superuser (ModelBackend) jeden Endpunkt für Passwort-Raten ohne Rate-Limit und am CSRF vorbei öffnet. Empfehlung für Bestandstools (abstimmbar, ausleihbar; erkennbar hat es bereits): dieselbe Zeile in config/settings.py übernehmen.
  • CLAUDE.md: Der ui-Release entsteht als Draft und muss manuell veröffentlicht werden, sonst ist der Tarball nicht abrufbar.
  • Template-Refresh (Framework-Review): Paket-Pins aktuell (integrations 0.2.2, auth 0.1.1, lti 0.1.4, ui 0.6.0 — bisher 0.1.0/0.1.0/0.1.2/0.2.1, d. h. ohne den clean_media_url-Sicherheitsfix); api.ts fällt im Prod-Build nicht mehr auf localhost zurück (same-origin) und behandelt 204/FormData korrekt; die 90-Zeilen-SettingsMenu-Kopie ist durch PreferencesMenu aus @basicbar/ui ersetzt (Katalog-Key „Preferences“); Settings verweigern DEBUG=0 mit dem Dev-SECRET_KEY.
  • Prod-Gerüst (bislang nur in abstimmbar/ausleihbar): Root-Dockerfile (Multi-Stage, SPA gebacken), docker-compose.prod.yml (Pflichtvariablen per :?), .env.prod.example, Release-Workflow nach GHCR.
  • Neue Copier-Frage ci_host (github/gitlab, Default github): rendert GitHub-Actions-CI + Release-Workflow oder die GitLab-Pipeline.
  • _skip_if_exists: copier update lässt Identitäts-/Inhaltsdateien (tailwind.config.js, App.tsx, locales, README/CLAUDE.md, Keycloak-Realm, Caddyfile, .env.prod.example) in Ruhe — erkennbars 11 Hue-Konflikte entfallen damit. _message_after_copy nennt die ersten Schritte.
  • Schlankere Images: kein libpq-dev/gcc mehr (Wheels), .dockerignore für Dev- und Prod-Build-Kontext; gunicorn entfernt (ASGI/uvicorn); ruff-Konfiguration (backend/pyproject.toml, Import-Sortierung) und echte Basis-Tests in common/tests.py.
  • Repo-CI: template-probe-Job rendert das Template (mit LTI) und fährt Lint, check, makemigrations --check, Tests gegen PostgreSQL und den Frontend-Build der generierten Anwendung; Paket-Jobs als Matrix mit Caches.
  • Migration Bestandstools (optional, per copier update --vcs-ref HEAD): Konflikte sind in Gerüst-Dateien (compose, Dockerfiles, settings, api.ts) zu erwarten — Diff lesen; die Identitätsdateien bleiben unberührt.

ui/v0.6.0 — 2026-10-01

@basicbar/ui

Geteilte Einstellungs-Bausteine (ausleihbar#35): LanguageOptions, AppearanceControl und PreferencesMenu. Die ersten beiden sind Menüzeilen für das Account-Menü des Tools (je eine beschriftete role="group" mit menuitemradio-Zeilen, gültig in role="menu"; LanguageOptions hat heading?); PreferencesMenu ist der runde Einstellungen-Button mit Popover für nicht angemeldete Besucher. Es gibt bewusst keinen Eintrag „Auto“ bei der Sprache: ohne Wahl folgt der Detector dem System (die angezeigte Sprache ist markiert), eine Wahl wird von i18next gecacht und ist damit verbindlich. onChange / onLanguageChange dienen zum serverseitigen Speichern. README: neuer Abschnitt „Preferences (language & appearance)“.

Migration: additiv, nichts zu tun. Die Tools ergänzen in ihren Katalogen den Schlüssel „Preferences“ (die übrigen — Appearance, Auto, „(follows your system)“, Light, Dark, Language — existieren meist schon).

ui/v0.5.1 — 2026-09-30

@basicbar/ui

CSP-tauglicher RichTextEditor (basicbar#9): TipTap hängte beim Mounten ein <style data-tiptap-style> mit den ProseMirror-Grundregeln an <head> — unter einer Content-Security-Policy mit style-src 'self' (ohne 'unsafe-inline') blockiert der Browser das, der Editor verliert dann u. a. sein Umbruchverhalten. Der Editor läuft jetzt mit injectCSS: false; die Regeln (unverändert aus @tiptap/core src/style.ts, TipTap 3.31) stehen in base.css — bewusst außerhalb jedes @layer, weil Tailwind die zur Laufzeit gesetzten ProseMirror-*-Klassen nicht sieht und gelayerte Regeln sonst entfernen würde. README: neuer Abschnitt „CSP“.

Migration: keine, solange das Tool @basicbar/ui/base.css importiert (wie im README beschrieben). Wer base.css nicht einbindet, muss die ProseMirror-Regeln selbst bereitstellen.

integrations/v0.2.1 — 2026-09-29

basicbar-integrations

Sicherheitsfix: clean_media_url prüfte den rohen String, sodass Pfade wie /media/%2e%2e/api/whoami/ oder /media/a\..\b durchkamen — Browser lösen die enthaltenen ..-Segmente nach dem Decodieren aber trotzdem auf, sodass ein admin-verfasstes <img> einen same-origin GET auf beliebige Pfade auslösen konnte (basicbar#6). Geprüft wird jetzt der decodierte, normalisierte Pfad; einfach- und doppelt-encodierte ..-Segmente sowie Backslashes werden abgelehnt.

Fix Runde 2 (basicbar#6): drei weitere Bypasses, die der WHATWG-URL- Parser aber ein reiner Substring-Check nicht sieht, sind jetzt ebenfalls abgedeckt: rohe oder %09/%0a/%0d-codierte C0-/DEL-Steuerzeichen (Browser entfernen sie überall im URL vor dem Auflösen, sodass z. B. /media/.&#9;./api/ sonst als /api/ aufgelöst würde); ein ?/# (roh oder codiert), das ein .. davor verbirgt (/media/..?x → /?x); und url[:300]-Truncation nach der Validierung, die einen validierten langen Pfad nachträglich wieder auf eine Traversal kürzen konnte — über 300 Zeichen wird jetzt komplett abgelehnt statt gekürzt.

Migration: keine — reiner Bugfix, die öffentliche Signatur von clean_media_url/clean_html ändert sich nicht.

ui/v0.5.0 — 2026-09-29

@basicbar/ui

Alt-Text für Bilder in RichTextEditor (basicbar#7, WCAG 1.1.1): direkt nach einem erfolgreichen Bild-Upload fragt der Editor per window.prompt nach einer Beschreibung (t("Image description (alt text)")) — leere Eingabe oder Abbrechen setzen beide alt="" (bewusst dekoratives Bild), das Bild wird in jedem Fall eingefügt. Neuer Toolbar-Button t("Image description") (nur sichtbar, wenn onUploadImage gesetzt ist), deaktiviert, solange kein Bild markiert ist; bei markiertem Bild öffnet er denselben Prompt vorausgefüllt mit dem aktuellen Alt-Text und übernimmt Änderungen per updateAttributes("image", { alt }) — Abbrechen lässt den bestehenden Alt-Text unangetastet. ToolbarButton hat dafür eine neue optionale disabled-Prop (reduzierte Deckkraft, aria-disabled).

Nebenbei behoben: useEditor setzt jetzt shouldRerenderOnTransaction: true — TipTap 3 rendert standardmäßig nicht mehr bei reinen Selektionsänderungen neu, sodass sämtliche Toolbar-Buttons (Fett/Kursiv/Überschriften/Link und jetzt auch der neue Bildbeschreibungs-Button), die ihren aktiven/deaktivierten Zustand aus editor.isActive(...) lesen, nach einem Klick ohne Dokument- änderung (z. B. Bild ab-/anwählen) den alten Stand zeigten, bis die nächste Bearbeitung ein Re-Render auslöste.

Migration: keine für Tools ohne onUploadImage — additiv. Tools mit Bild-Upload ergänzen die neuen Übersetzungs-Keys "Image description (alt text)" und "Image description".

ui/v0.4.0 — 2026-09-27

@basicbar/ui

RichTextEditor + RichText (modulierbar#5), aus AbstimmBAR verschoben: der eine WYSIWYG-Editor (TipTap) für formatierte Langtext-Felder — Fett, Kursiv, Aufzählungen, nummerierte Listen, Link, Überschriften (H2/H3) und optional Bilder — plus RichText zum Rendern des gespeicherten HTML. Bilder (Toolbar-Button, Drag&Drop, Einfügen aus der Zwischenablage) gibt es nur, wenn die App onUploadImage(file) => Promise<string> übergibt (relative URL, z. B. /media/rich/x.png); ohne die Prop bleiben bestehende <img>- Inhalte sichtbar, es lassen sich nur keine neuen einfügen. Auf Upload-Fehler zeigt der Editor t("Image upload failed") per window.alert und lässt den Inhalt unverändert. Passt zum Sanitizing-Vertrag von basicbar_integrations.html_sanitize.clean_html (oder einem gleichwertigen Allowlist-Sanitizer im Tool) — die gespeicherte HTML wird dort auf genau dieses Subset reduziert. Eingefügtes Rich-HTML (z. B. aus einer Webseite kopiert) wird per transformPastedHTML gefiltert: jedes <img>, dessen src nicht mit /media/ beginnt, wird entfernt — ohne onUploadImage wird jedes eingefügte <img> entfernt. So kann kein externes Bild am Upload-Flow vorbei ins Dokument gelangen; vorhandene Bilder im initialen value bleiben unangetastet.

Neue Dependencies: @tiptap/react, @tiptap/pm, @tiptap/starter-kit, @tiptap/extension-link, @tiptap/extension-image, @tiptap/extension-bold (alle ^3.27.2); react-dom (>=18) ist jetzt zusätzlich zu react als Peer-Dependency deklariert (@tiptap/react importiert es zur Laufzeit).

Der Editor bietet bewusst nur das Subset an, das der Sanitizer behält: Unterstreichen/Durchgestrichen sind nicht registriert und Links tragen kein target/rel (das Backend erzwingt rel="noopener" ohnehin). Der externe value-Sync (Sprachwechsel u. ä.) läuft jetzt außerhalb der Undo-History (setMeta("addToHistory", false)), damit ein Undo direkt danach nicht in den vorherigen Inhalt hineinspringt. RichTextEditor hat eine neue optionale Prop labelledBy (Id eines externen <label>, Alternative zu ariaLabel); RenderInputArgs (für renderInput) hat entsprechend ein neues optionales Feld labelId — TranslatableFields eigene Label-Id, additiv und abwärtskompatibel. Der Bild-Upload-Button ist jetzt per aria-label benannt und zeigt einen sichtbaren Fokusring; ein fehlgeschlagener Bild-Upload zeigt zusätzlich zu t("Image upload failed") die Fehlermeldung, falls vorhanden.

Migration: keine für Tools, die die Komponente noch nicht nutzen — additiv. Ein Tool, das den Editor einsetzt, übernimmt RichTextEditor/RichText aus @basicbar/ui statt einer lokalen Kopie (z. B. via TranslatableFields renderInput, labelledBy={labelId} durchreichen) und ergänzt die Übersetzungs-Keys "Bold", "Italic", "Heading (large)", "Heading (small)", "Bulleted list", "Numbered list", "Link", "Enter URL", "Insert image (or drag and drop)", "Image upload failed".

ui/v0.3.1 — 2026-08-28

@basicbar/ui

Globaler Sprach-Umschalter (modulierbar#99): Der schwebende Übersetzungs-Block zeigt jetzt einen kompakten DE/EN-Umschalter, der mit einem Klick alle gemounteten TranslatableField auf eine Sprache stellt (über den bestehenden forced-Mechanismus, ohne zu übersetzen) — praktisch, um einen Datensatz Feld für Feld in einer Sprache zu befüllen. Sichtbar, sobald mehrsprachige Felder auf dem Bildschirm sind (unabhängig von der Maschinenübersetzung); der „Alle Felder übersetzen"-Button bleibt daran gekoppelt.

Migration: keine — rein additiv. Neue UI-Strings "Show all fields in one language" und "Show all fields in {{language}}" (Tools ergänzen ihre Übersetzungen).

integrations/v0.2.0 + ui/v0.3.0 — 2026-07-23

basicbar-integrations und @basicbar/ui

Veraltete Übersetzungen markieren (modulierbar#31, generisch für alle Tools): Wird eine Sprache nach der Übersetzung geändert, gilt die unveränderte Gegensprache als „möglicherweise veraltet“ — sichtbar im Editor, abfragbar im Release-Prozess, per „Als aktuell markieren“ quittierbar. Ändern sich beide Sprachen, wird nichts markiert (bewusste Doppel-Korrektur). Felder ohne aufgezeichneten Sync-Stand (Bestandsdaten) werden nie markiert.

  • basicbar_integrations.translation_sync (neu): content_hash, record_synced, changed_languages, stale_languages, stale_map, modeltranslation_values. Zustand lebt pro Model in einem vom Tool angelegten JSONField (eine Zeile + Migration).
  • @basicbar/ui TranslatableField: neue optionale Props stale (Sprachcodes → amber Tab-Punkt + Hinweiszeile), onMarkSynced („Als aktuell markieren“) und onTranslated (nach Maschinen- übersetzung — hier den Sync-Stand persistieren). Der Übersetzen-Button erscheint bei veralteten Sprachen auch auf gefülltem Feld (explizites Neu-Übersetzen); TranslationForm-Einträge unterstützen onTranslated ebenfalls („alle Felder übersetzen“ hält den Sync-Stand aktuell, überschreibt aber weiterhin nie gefüllte Felder).

Migration (Adoption ist opt-in — ohne neue Props/Aufrufe ändert sich nichts):

  1. Model: translation_sync = models.JSONField(default=dict, blank=True)
    • Migration.
  2. Beim Speichern übersetzungsrelevanter Endpunkte bzw. in einem eigenen „mark synced“-/onTranslated-Endpunkt: record_synced() aufrufen.
  3. Serializer: translation_stale = stale_map(instance.translation_sync, {feld: modeltranslation_values(instance, feld, ("de", "en")), …}) ausliefern; Frontend reicht es als stale-Prop durch und ruft bei onMarkSynced/onTranslated den Endpunkt aus Schritt 2.
  4. Release-Checks: stale_map() über die zu prüfenden Objekte.
  5. Neue Katalog-Schlüssel (de-Übersetzungen ergänzen): translation may be outdated, The other language was changed since this translation., Mark as up to date.

lti/v0.1.3 — 2026-07-20

basicbar-lti (Eintrag nachgetragen am 2026-08-04)

  • lti_login antwortet bei fehlenden Parametern (iss, login_hint, target_link_uri) und nicht auflösbarer Plattform-Registrierung (Issuer/Client-ID-Mismatch, auch Trailing-Slash) mit erklärendem 400 statt opakem 500; pylti1p3-Exceptions werden abgefangen. Migration: Version heben, sonst nichts.

lti/v0.1.2 — 2026-07-19

basicbar-lti

  • LTI-1.3-Fundament (Phase 5), aus abstimmbar extrahiert: LtiPlatform/ LtiToolKey/LtiUserLink, build_tool_conf, lti_login/lti_jwks, Staff-Platform-API, JIT-Provisionierung mit E-Mail-Unifizierung (Opt-in pro Plattform), Constraint-Namen mit Paket-Präfix (koexistenz- sicher während der Umzugsmigration), Frame-Ancestors-Middleware (LTI_FRAME_PATH_PREFIXES konfigurierbar). 28 Tests inkl. simuliertem LMS-Handshake.
  • Bewusst Tool-seitig: Message-Launch, Deep Linking, Kontext-Link-Model (FK auf Fachmodelle) und Icon — komponiert aus den Paket-Primitiven.
  • Migration abstimmbar: Daten-Umzugsmigration (lti/0003) kopiert Plattformen/Keys/User-Links PK-erhaltend in die Paket-Tabellen und hängt den Kontext-Link-FK um — läuft als normales manage.py migrate, kein manueller Schritt.
  • ausleihbar: keine Änderung — die Fähigkeit kommt bei Bedarf über Paket + eigene Launch-App.

auth/v0.1.0 — 2026-07-19

basicbar-auth

  • Erstes Auth-Paket (Phase 4): OIDCBackend (Claim-Mapping, JIT- Provisionierung, IdP-Gruppen → Django-Admin), SilentLoginView, Back-Channel-Logout, provider_logout_url, is_oidc_admin, discovery.discover_endpoints, AbstractBasicUser (ADR-0003).
  • Die bewussten Tool-Unterschiede aus Phase 0 sind jetzt Konfiguration: MAX_USERS (Obergrenze; anonymized_at-Konvention zählt anonymisierte Konten nicht) und OIDC_MATCH_BY_USERNAME_FALLBACK (Subject-Drift- Heilung per Username-Match, Default aus). Betreiber-Doku zu Fristen und Kennungs-Wiedervergabe im Paket-README.
  • 25 Tests (aus beiden Tools portiert und vereinigt, inkl. der neuen Flag-Pfade), eigener CI-Job.
  • Migration beide Tools: accounts/oidc.py + config/oidc_discovery.py löschen; AUTHENTICATION_BACKENDS/OIDC_OP_LOGOUT_URL_METHOD auf basicbar_auth.oidc.*; Importe in urls/views/serializers umstellen; INSTALLED_APPS + basicbar_auth. User-Model bleibt unangetastet.
  • Migration abstimmbar zusätzlich: OIDC_MATCH_BY_USERNAME_FALLBACK=True setzen (bisheriges Verhalten, an der UOS unkritisch — Kennungen werden nicht neu vergeben).

ui/v0.2.1 — 2026-07-19

@basicbar/ui

  • Neu: TranslatableField + TranslationFormProvider/useTranslationForm — die vereinheitlichte Übersetzungs-Editor-Komponente beider Tools. Vertrag: per Sprache (values + onChange(lang, text)), n Sprachen aus SUPPORTED_LANGUAGES (UI-Sprache-zuerst), renderInput für Custom-Editoren, singleLanguage (Easy Mode) als Prop, format="html" (Statuspunkte ignorieren Markup, Übersetzung erhält es), MAX_TRANSLATE_LENGTH-Kappe. Der HTTP-Aufruf wird vom Tool injiziert: <TranslationFormProvider translate={…}>.
  • Neue Peer-Dependency: lucide-react.
  • Migration beide Tools: lokale TranslatableField/TranslationForm ersetzen; tailwind.config content um ./node_modules/@basicbar/ui/dist/**/*.js erweitern (Komponenten-Klassen müssen gescannt werden); Provider bekommt die translate-Funktion.
  • Migration ausleihbar: api.translate um format-Parameter erweitern; Aufrufstellen bleiben unverändert (gleicher Feld-Vertrag).
  • Migration abstimmbar: lokaler Wrapper behält value/onChange(next), variant="rich" (RichTextEditor) und Easy Mode; Tab-Reihenfolge folgt jetzt der UI-Sprache statt fix kanonisch-zuerst.

ui/v0.1.0 — 2026-07-19

@basicbar/ui

  • Erstes UI-Paket (Phase 3), Modell „ein Designsystem, pro Tool ein eigener Akzent“: createPreset({ colors }) (Font, Dark Mode per .dark-Klasse, Motion-Tokens; die slate/brand-Ramps bleiben als Identität im Tool), base.css (A11y-Basis: focus-visible-Ring, Skip-Link, reduced-motion, color-scheme, accent-color), ThemeProvider/useTheme/prePaintScript (Auto/Light/Dark, storageKey konfigurierbar), initI18n({ resources }) und contentLang.
  • Distribution: npm-Tarball via GitLab Generic Package Registry, CI-Publish beim Tag ui/vX.Y.Z.
  • Migration ausleihbar: tailwind.config auf Preset, index.css auf @import "@basicbar/ui/base.css", theme.tsx/i18n.ts/contentLang.ts löschen und Importe auf @basicbar/ui umstellen.
  • Migration abstimmbar: dito; zusätzlich ThemeProvider statt des lokalen Theme-Moduls (mit storageKey="abstimmbar_theme" für Bestandsnutzer).

integrations/v0.1.0 — 2026-07-19

basicbar-integrations

  • Erstes Paket (Phase 2): ai (LiteLLM-Client) und translation_service (LibreTranslate-Client) aus den konsolidierten Tool-Fassungen übernommen; Settings-Zugriff jetzt mit Paket-Defaults (conf.py) — unkonfiguriert ist alles aus, ein Tool ohne Settings-Block startet unverändert.
  • Kanonischer Translate-Endpunkt: POST {text, source, target, format?} → {translated}; Sprachvalidierung, HTML-Sanitizing (html_sanitize.py aus abstimmbar, jetzt mit nh3-Abhängigkeit), englische Fehlertexte.
  • Neu: Capabilities-Endpoint (GET → {"translation": bool, "ai": bool}, erweiterbar per extra_capabilities()).
  • Migration ausleihbar: Response-Key translation → translated, URL /api/manage/translate/ → Paket-URL, TranslateView-Subclass für die IsLenderOrAdmin-Permission, Format-Validierung neu.
  • Migration abstimmbar: Fehlertexte nun englisch; Imports common.ai / common.translation_service / common.html_sanitize → basicbar_integrations.*.

Repo

  • Phase 1: Repo-Gerüst, ADRs 0001–0003, CI (SPDX-Check), Extraktionsplan.
  • CI: Testjob für basicbar-integrations (python:3.12-slim).