feat: add translation support for sorting in UI and update locale files

Author: deleonio

packages/components/AGENTS.md

@@ -35,3 +35,15 @@ Use the `condition && <Element />` pattern to render JSX elements only when a co
 ```
 
 Avoid using `hidden={condition}` unless the element should always be present in the DOM but visually hidden.
+
+### Language texts
+
+All UI texts must be stored in `src/locales/en.ts` and `src/locales/de.ts`.
+New translations get the prefix `kol-` and are referenced in the code using the
+`translate()` helper, e.g. `translate('kol-example')`.
+Call `translate()` once when the component instance is created (e.g. in a field
+initializer) and reuse the result. This prevents unnecessary work while still
+updating texts when the component is rerendered. Cache the value in a class
+property whose name starts with `translate` followed by the translation
+identifier, for example `translateSort` for `kol-sort` or `translateOrderBy`
+for `kol-order-by`.

packages/components/src/components/table-stateless/component.tsx

@@ -61,6 +61,8 @@ export class KolTableStateless implements TableStatelessAPI {
 
 	private checkboxRefs: HTMLInputElement[] = [];
 
+	private translateSort = translate('kol-sort');
+
 	@State()
 	private tableDivElementHasScrollbar = false;
 
@@ -671,6 +673,7 @@ export class KolTableStateless implements TableStatelessAPI {
 						exportparts="icon"
 						_icons={{ right: sortButtonIcon }}
 						_label={cell.label}
+						_ariaDescription={this.translateSort}
 						_on={{
 							onClick: (event: MouseEvent) => {
 								if (typeof this.state._on?.onSort === 'function' && cell.key && cell.sortDirection) {

packages/components/src/components/table-stateless/readme.md

@@ -71,6 +71,9 @@ const selection: KoliBriTableSelection = {
 />
 ```
 
+Der Sortierschalter verwendet das Attribut `_aria-description` und zeigt immer den
+Sprachtext `kol-sort` an, unabhängig vom aktuellen Sortierzustand.
+
 <!-- Auto Generated Below -->
 
 ## Properties

packages/components/src/locales/de.ts

@@ -48,6 +48,7 @@ export default {
 	'hide-password': 'ausblenden',
 	'no-results-message': 'Keine Ergebnisse gefunden.',
 	'delete-selection': 'Auswahl entfernen',
+	sort: 'sortieren',
 	'pagination-position-top': 'oben',
 	'pagination-position-bottom': 'unten',
 };

packages/components/src/locales/en.ts

@@ -48,6 +48,7 @@ export default {
 	'hide-password': 'Hide',
 	'no-results-message': 'No results found.',
 	'delete-selection': 'Delete selection',
+	sort: 'sort',
 	'pagination-position-top': 'top',
 	'pagination-position-bottom': 'bottom',
 };