Merge branch 'develop' into 5674-_nicht-interaktives-Element-wird-fok…

…ussiert
public-ui · Dec 13, 2023 · 69f9d56 · 69f9d56
2 parents 4d3fd79 + e48d3d8
commit 69f9d56
Show file tree

Hide file tree

Showing 358 changed files with 2,381 additions and 2,225 deletions.
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -4,10 +4,16 @@ env:
   access: public
   registry: https://registry.npmjs.org
   token: ${{ secrets.NPMJS_GRANULAR_TOKEN }}
-  tag: next
 
 on:
   workflow_dispatch:
+    inputs:
+      tag:
+        type: choice
+        description: Which NPM tag should be assigned?
+        options: 
+          - next
+          - latest
 
 jobs:
   publish:
@@ -50,127 +56,128 @@ jobs:
         run: pnpm -r build
 
       - name: Build and publish schema
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        continue-on-error: true
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/schema
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish components
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/components
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v11
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v11
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v12
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v12
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v13
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v13
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v14
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v14
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v15
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v15
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v16
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v16
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter angular v17
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/angular/v17
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter react
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/react
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter react-standalone
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/react-standalone
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter solid
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/solid
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter vue
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/vue
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter preact
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/preact
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish adapter hydrate
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/adapters/hydrate
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish create-kolibri
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/create-kolibri
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish tools kolibri-cli
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/tools/kolibri-cli
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish theme default
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/themes/default
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish themes
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/themes
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish sample react
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/samples/react
         env:
           NODE_AUTH_TOKEN: ${{env.token}}
       - name: Build and publish tools visual-tests
         continue-on-error: true
-        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{env.tag}}
+        run: pnpm publish --access ${{env.access}} --no-git-checks --tag ${{github.event.inputs.tag}}
         working-directory: packages/tools/visual-tests
         env:
           NODE_AUTH_TOKEN: ${{env.token}}

diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
@@ -2,16 +2,17 @@
 
 name: 'Close stale issues and PRs'
 on:
+  workflow_dispatch:
   schedule:
-    - cron: '0 6 * * *'
+    - cron: '0 4 * * *'
 
 jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/stale@v8
         with:
-          days-before-stale: 365 # @todo Revert to 170 after testing
+          days-before-stale: 170
           days-before-close: 10
           days-before-pr-close: -1 # Don't close PR's
           stale-issue-message: 'This issue has been automatically marked as stale and will be closed in 10 days because it has not had recent activity and is much likely outdated. If you think this issue is still relevant and applicable, please post a comment or remove the Stale label.'

diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -1,5 +1,5 @@
 {
-	"editor.formatOnSave": false,
+	"editor.formatOnSave": true,
 	"editor.renderWhitespace": "all",
 	// Configure glob patterns for excluding files and folders.
 	// For example, the files explorer decides which files and folders to show

diff --git a/MIGRATION.de.md b/MIGRATION.de.md
@@ -0,0 +1,70 @@
+# Migration
+
+## Einleitung
+
+Neue Major-Versionen von KoliBri werden mit dem Ziel entwickelt, die Wartung und Pflege zu vereinfachen und Weiterentwicklung zu fördern.
+
+Dies bedeutet, dass ggf. Komponenten, Eigenschaften oder Funktionalitäten entfernt werden und technologische Voraussetzungen geschaffen werden, um einen zukünftigen innovativen Wandel zu begünstigt.
+
+- **Wartungs- und Pflegestrategie:**<br/>
+  Wir werden immer die neuste und die vorherige Major-Version von KoliBri pflegen. Dies bedeutet, dass wir für diese Versionen Fehler beheben und Sicherheitslücken schließen. Für alle anderen Versionen werden wir ohne Weiteres keine Fehlerbehebungen oder Sicherheitsupdates mehr bereitstellen.
+- **Weiterentwicklung:**<br/>
+  Wir werden immer die neuste Major-Version von KoliBri weiterentwickeln. Dies bedeutet, dass wir für diese Versionen neue Features und Funktionalitäten bereitstellen. Für alle anderen Versionen werden wir ohne Weiteres keine neuen Features oder Funktionalitäten mehr bereitstellen.
+- **Vor der Migration einen lauffähigen Stand sichern:**<br/>
+  Bevor die Migration erfolgt, empfehlen wir einen lauffähigen Stand einzuchecken und somit keine uncommiteten Änderungen auf dem zu migrierenden Quellcode zu haben. Während und nach der Migration können so alle Änderungen gut nachvollzogen und geprüft werden.
+- **Migrationstool:**<br/>
+  Wir stellen ein Migrationstool bereit, welches generell die Migration von Quellcode mit KoliBri unterstützt. Dieses Tool ist in der Lage, die meisten Breaking Changes automatisch zu migrieren. Weitere Informationen finden Sie in der [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
+- **Hilfe und Feedback:**<br/>
+  Sollte es Probleme bei der Migration geben, stehen wir gerne zur Verfügung. Bitte eröffnen Sie ein [Issue auf GitHub](https://github.com/public-ui/kolibri/issues/new/choose).
+
+## Migration von Version 1 auf Version 2
+
+### Hinweise zum Upgrade auf Version 2
+
+1. **Neue Eigenschaften in Version 2 bereits ab Version 1.7 verfügbar:**<br/>
+   Die meisten neuen Eigenschaften, die in Version 2 eingeführt werden, sind bereits ab der Version 1.7 und höher verfügbar. Dies bedeutet, dass Anwendungen, die auf Version 1.7 oder höher basieren, möglicherweise bereits über die erforderlichen Funktionen verfügen, um eine reibungslose Migration zu ermöglichen.
+
+2. **Entfernte Eigenschaften, Komponenten und Funktionalitäten waren in Version 1.7 und höher bereits als veraltet markiert:**<br/>
+   Alle Eigenschaften, Komponenten und Funktionalitäten, die in Version 2 entfernt wurden, waren in Version 1.7 und höher bereits als veraltet (`deprecated`) gekennzeichnet. Wenn Sie also regelmäßig Ihre Codebasis aktualisiert haben, sollten Sie bereits darauf vorbereitet sein, diese Elemente zu ersetzen.
+
+3. **Migration ab Version 1.7 minimiert potenzielle Änderungen:**<br/>
+   Eine Migration von Version 1.7 und höher auf Version 2.0.0 wird voraussichtlich die geringsten Anpassungen erfordern. Die Wahrscheinlichkeit von Inkompatibilitäten ist niedrig, da die meisten Änderungen und Entfernungen bereits in den vorherigen Versionen als veraltet markiert wurden.
+
+4. **Migration ab Version 1.4 ist möglich:**<br/>
+   Obwohl eine Migration ab Version 1.7 empfohlen wird, ist es auch möglich, von Version 1.4 auf Version 2.0.0 zu migrieren. Beachten Sie jedoch, dass dies möglicherweise zusätzliche Anpassungen erfordert, da einige der notwendigen Funktionen möglicherweise erst ab Version 1.7 verfügbar sind.
+
+5. **Vereinfachte Registrierung beachten:**<br/>
+   Wir haben in Version 1 und für Version 2 die Modularisierung von KoliBri vereinfacht. Das Modul `@public-ui/core` wurde entfernt und die Funktionalitäten in das Modul `@public-ui/components` verschoben.
+
+```diff
+  - import { register } from '@public-ui/core';
+  + import { register } from '@public-ui/components';
+  import { defineCustomElements } from '@public-ui/components/dist/loader';
+  import { MyTheme } from '...';
+  await register(MyTheme, defineCustomElements);
+```
+
+### Breaking Changes für Version 2
+
+Mehr Informationen zu Breaking Changes finden Sie in der Dokumentation [BREAKING_CHANGES.v2.md (EN)](https://github.com/public-ui/kolibri/blob/develop/docs/BREAKING_CHANGES.v2.md).
+
+## Migration durchführen
+
+> [!TIP]
+> Wir empfehlen, die Migration mit dem Migrationstool durchzuführen. Dieses Tool ist in der Lage, die meisten Breaking Changes automatisch zu migrieren. Weitere Informationen finden Sie in der [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
+
+### Migration mit Migrationstool
+
+1. **Vorbereitung:**<br/>
+   Das Projekt ist auf einer früheren Version, alle Abhängigkeiten sind installiert, das Projekt ist lauffähig und alle Änderungen sind eingecheckt und sicher gepusht.
+2. **Migration ausführen:**<br/>
+   Führen Sie den folgenden Befehl aus, um das Migration auszuführen: `npx @public-ui/kolibri-cli migrate src`
+3. **Migration prüfen:**<br/>
+   Prüfen Sie die Änderungen und führen Sie die Anwendung aus, um sicherzustellen, dass alles wie erwartet funktioniert.
+
+### Migration manuell durchführen
+
+1. **Vorbereitung:**<br/>
+   Das Projekt ist auf einer früheren Version, alle Abhängigkeiten sind installiert, das Projekt ist lauffähig und alle Änderungen sind eingecheckt und sicher gepusht.
+2. **Migration durchführen:**<br/>
+   Führen Sie die Migration durch, indem Sie die Breaking Changes in der jeweiligen Dokumentation.