Komponenten in einer UI-Komponentenbibliothek mit Theme-Unterstützung erstellen oder ändern

## Die Dateien finden, die eine Komponentenänderung betrifft Handeln Sie als sorgfältig mitwirkende Person an einer wiederverwendbaren, thematisch anpassbaren und barrierefreien Komponentenbibliothek. Ermitteln Sie vor der Bearbeitung das gewünschte Verhalten, die betroffene Komponente oder Hilfsfunktion und alle unmittelbar zugehörigen Bereiche. Orientieren Sie sich an der tatsächlichen Struktur des Quellcodearchivs, rechnen Sie aber damit, dass eine Komponentenänderung einige der folgenden Bereiche umfasst: - Laufzeitkomponenten und wiederverwendbare Logikbausteine. - Öffentlich bereitgestellte Typen und Exporte. - Themenrezepte, Varianten und Standardwerte. - Modul-, Darstellungs-, Momentaufnahme- und Barrierefreiheitstests. - Benutzerdokumentation und Beispiele. - Eine lokale Testumgebung oder Vorführseite. Gehen Sie nicht davon aus, dass alle Bereiche geändert werden müssen. Verfolgen Sie die bestehende Komponente und ihr ähnlichstes Gegenstück und führen Sie dann nur die für den Auftrag erforderlichen Bereiche auf. Beschränken Sie die Quellcode- und Testkonventionen auf diese Verzeichnisse; wenden Sie sie nicht unbesehen auf Dokumentation, Beispiele oder Werkzeuge an. Bewahren Sie das bestehende öffentliche Verhalten, sofern die Aufgabe es nicht ausdrücklich ändert. Behandeln Sie die Weitergabe von Attributen, die Auflösung von Standardwerten, die Bedeutung für die Barrierefreiheit, das Verhalten bei Schreibrichtung von rechts nach links und dokumentierte Programmierschnittstellen als Verträge statt als Implementierungsdetails. ## Nur die nötigen Leitfäden lesen und mit dem Generator beginnen Lesen Sie zuerst die beitragsbezogenen Vorgaben für das gesamte Quellcodearchiv und laden Sie danach nur die für die Aufgabe relevanten Referenzen. Verwenden Sie beispielsweise die Vorgaben zur Komponentenstruktur für Eigenschaften (`props`), Einfügebereiche (`slots`), Ereignisse (`events`) und Vorlagenmuster, die Themenvorgaben für Einfügebereiche und Varianten, die Testvorgaben für Darstellung, Momentaufnahmen und Barrierefreiheit sowie die Dokumentationsvorgaben für Beispiele und Auszeichnung. Laden Sie nicht jede Referenz nur deshalb, weil sie vorhanden ist. Beginnen Sie mit der betroffenen Datei, untersuchen Sie eine aktuelle vergleichbare Implementierung und öffnen Sie zusätzliche Vorgaben nur, wenn die Änderung den jeweiligen Bereich berührt. Verwenden Sie die im Projekt festgelegten Paketskripte und die unterstützte Paketverwaltung. Führen Sie nach der Installation der Abhängigkeiten alle erforderlichen Vorbereitungs- oder Typerzeugungsschritte aus, bevor Sie eine Testumgebung, die Dokumentationsseite oder Prüfungen starten. Nutzen Sie die für die Änderung geeignete lokale Umgebung: die Testumgebung der Hauptanwendung, die Testumgebung eines anderen Rahmenwerks, eine gezielte Reproduktionsumgebung oder die Dokumentationsseite. Bevorzugen Sie beim Erstellen einer Komponente den vom Quellcodearchiv genehmigten Generator. Prüfen Sie die erzeugten Dateien vor der Bearbeitung und fordern Sie nur die für die Aufgabe benötigten Vorlagen an. Falls kein Generator geeignet ist, bilden Sie die etablierte Dateianordnung und die Namenskonventionen manuell nach. ## Die Rangfolge der Theme-Standardwerte und die Layouts von rechts nach links erhalten Befolgen Sie die etablierten Codekonventionen der Bibliothek durchgängig: - Halten Sie reine Typimporte getrennt, wenn die Werkzeugkette oder die Stilvorgaben dies verlangen. - Definieren Sie Laufzeitstandardwerte für Eigenschaften über die vorgesehene Hilfsfunktion und dokumentieren Sie öffentliche Standardwerte in der typbezogenen Programmierschnittstelle. - Fügen Sie den dargestellten Elementen stabile Einfügebereichsmarkierungen hinzu. Am Wurzelelement muss eine vom Aufrufenden gesetzte Markierung den Rückfallwert der Komponente überschreiben; innere Elemente behalten ihre eigenen Markierungen. - Wenn die automatische Weitergabe von Attributen deaktiviert ist, ordnen oder lösen Sie die Bindungen des Wurzelelements so auf, dass Attribute des Aufrufenden nicht unbemerkt überschrieben werden. - Erzeugen Sie eine reaktive Themenausgabe über den vorgesehenen Berechnungsmechanismus, statt den Themenzustand nur einmal auszuwerten. - Lösen Sie Standardwerte über die vollständige Rangfolge auf: ausdrückliche Komponenteneingabe, nächster Gruppen- oder Feldkontext, thematische Überschreibungen auf Bibliotheksebene, Komponentenstandardwerte und anschließend die vom Projekt definierte Anwendungskonfiguration. - Übergeben Sie unverarbeitete Eingaben an Kontexthilfen, wenn eine Stellvertreterabbildung die Rangfolge der Einbindung verändern würde. Fehlt ein näherer Kontext, greifen Sie auf den aufgelösten Komponentenwert zurück, statt einen themenbezogenen Standardwert zu verwerfen. - Leiten Sie Eigenschaften und Ereignisse der Bibliothek elementarer Bausteine über den projektspezifischen Adapter mit Unterstützung für Stellvertreterobjekte weiter, damit aufgelöste Standardwerte erhalten bleiben. Verwenden Sie semantische Gestaltungsvariablen anstelle roher Palettenwerte. Nutzen Sie logische Eigenschaften für Abstände, Position, Rahmen, Rundungen und Textausrichtung, damit Anordnungen sowohl bei Schreibrichtung von links nach rechts als auch von rechts nach links funktionieren. Ergänzen Sie für Transformationen, Zeigerformen, Farbverläufe oder Übergänge ausdrücklich richtungsabhängige Alternativen, wenn sich das Verhalten nicht mit logischen Eigenschaften ausdrücken lässt. Richten Sie die Implementierung an den vorhandenen Mustern aus. Führen Sie nicht für eine einzelne Komponente ein konkurrierendes System für Standardwerte, einen weiteren Weitergabepfad für Eigenschaften oder eine zusätzliche Themenauflösungsschicht ein. ## Eine Komponente per Prüfliste vom Theme bis zu Tests und Dokumentation umsetzen Verfolgen Sie eine neue Komponente oder eine wesentliche Komponentenfunktion mit dieser Prüfliste: 1. Erzeugen oder erstellen Sie das Grundgerüst der Komponente am vorgesehenen Laufzeitort. 2. Implementieren Sie Verhalten, öffentliche Eigenschaften, Einfügebereiche, Ereignisse und die Bedeutung für die Barrierefreiheit. 3. Ergänzen oder aktualisieren Sie das Themenrezept einschließlich Einfügebereichen, Varianten, kombinierten Varianten und semantischen Gestaltungsvariablen. 4. Exportieren Sie öffentliche Typen und registrieren Sie alle vom Themensystem benötigten Schnittstellen für Komponentenstandardwerte. 5. Ergänzen Sie je nach Bedarf gezielte Tests für Verhalten, Eigenschaften, Einfügebereiche, Attributweitergabe, Schreibrichtung und Barrierefreiheit. 6. Aktualisieren Sie die Benutzerdokumentation mit Verwendungshinweisen, Beispielen und Einzelheiten der Programmierschnittstelle. 7. Ergänzen oder aktualisieren Sie ein Beispiel in der Testumgebung, das das geänderte Verhalten zeigt. 8. Führen Sie Codeprüfung, statische Typprüfung und die betreffende Testsammlung aus. Verwenden Sie Momentaufnahmen nur dort, wo das Projekt sie als nützlichen Vertrag betrachtet, und prüfen Sie erzeugte Änderungen, statt sie automatisch zu übernehmen. Konzentrieren Sie Tests auf äußerlich bedeutsames Verhalten und bekannte Rangfolgeregeln. Wenn die Dokumentation vor einer Paketversion bereitgestellt wird, behalten Sie die vom Projekt genehmigte Vorabversionskennzeichnung an betroffenen Überschriften oder Beispielen bei. Die Kennzeichnung weist bewusst darauf hin, dass zusammengeführte Dokumentation Funktionen beschreiben kann, die erst mit der nächsten Version ausgeliefert werden; entfernen Sie sie nicht und melden Sie sie nicht als Widerspruch, ohne die Veröffentlichungsrichtlinie zu prüfen. ## Lint und Tests wirklich ausführen und den Änderungsantrag mit den Ergebnissen stellen Vergleichen Sie den abschließenden Änderungsvergleich mit den ähnlichsten etablierten Mustern und dem ursprünglichen Auftrag. Prüfen Sie: - Komponentenstruktur, öffentliche Typen und Exporte sind einheitlich. - Der Themencode verwendet semantische Gestaltungsvariablen und bewahrt die vollständige Rangfolge der Standardwerte. - Wurzelattribute und Einfügebereichsmarkierungen respektieren Überschreibungen durch den Aufrufenden. - Logische Eigenschaften oder ausdrückliche Richtungsvarianten decken das Verhalten bei Schreibrichtung von rechts nach links ab. - Tests decken die geänderten Eigenschaften, Einfügebereiche, Verhaltensweisen und Barrierefreiheitsanforderungen ab. - Die Dokumentation enthält die erforderlichen Verwendungshinweise, Beispiele und Änderungen der Programmierschnittstelle. - Absichtlich gesetzte Vorabversionskennzeichnungen in der Dokumentation bleiben erhalten. Führen Sie die Befehle des Quellcodearchivs für Codeprüfung, Typprüfung und die betreffenden Tests aus und melden Sie deren tatsächliche Ergebnisse. Behaupten Sie nicht allein aufgrund einer Sichtprüfung, die Prüfungen seien erfolgreich. Aktualisieren Sie die Dokumentation, wenn sich das öffentliche Verhalten ändert. Verwenden Sie die vorgeschriebene Konvention für Commit-Nachrichten und die Vorlage für Änderungsanträge des Quellcodearchivs. Verknüpfen Sie den zugehörigen Arbeitspunkt, benennen Sie die Änderungsart, beschreiben Sie Verhalten und Überprüfung und markieren Sie nur Prüflisteneinträge als erledigt, die durch Nachweise gestützt sind. Schreiben Sie den Commit-Verlauf einer mitwirkenden Person nicht allein der Ordnung halber um, führen Sie kein `rebase` oder `force-push` aus und fassen Sie ihn nicht zusammen. Mehrere Entwicklungs-Commits können zulässig sein, wenn das Quellcodearchiv eine zusammenfassende Zusammenführung durchführt; halten Sie sich an die tatsächliche Zusammenführungsrichtlinie des Quellcodearchivs und die Genehmigung des Benutzers.