Angular v19 migration

.changelog/20251120181522_i_514.md

@@ -0,0 +1,45 @@
+---
+# Required: Type of change.
+# Allowed values:
+# - Feature
+# - Fix
+# - Other
+# - Major breaking change
+# - Minor breaking change
+#
+# For guidance on breaking changes, see:
+# https://ckeditor.com/docs/ckeditor5/latest/updating/versioning-policy.html#major-and-minor-breaking-changes
+type: Breaking change
+
+# Optional: Affected package(s), using short names.
+# Leave empty when used in a single-package repository.
+# Example: ckeditor5-core
+scope:
+  - 
+
+# Optional: Issues this change closes.
+# Format:
+# - {issue-number}
+# - {repo-owner}/{repo-name}#{issue-number}
+# - Full GitHub URL
+closes:
+  - 514
+
+# Optional: Related issues.
+# Format:
+# - {issue-number}
+# - {repo-owner}/{repo-name}#{issue-number}
+# - Full GitHub URL
+see:
+  - 
+
+# Optional: Community contributors.
+# Format:
+# - {github-username}
+communityCredits:
+  - 
+
+# Before committing, consider removing all comments to reduce file size and enhance readability.
+---
+
+Changed minimum supported version of Angular to `>=19.x`.

README.md

@@ -25,7 +25,7 @@ Because of the breaking changes in the Angular library output format, the `@cked
 <table>
   <thead>
     <tr>
-      <th>Package&nbsp;version</th>
+      <th>CKEditor&nbsp;5&nbsp; Angular component version</th>
       <th>Angular&nbsp;version</th>
       <th>Details</th>
     </tr>
@@ -34,48 +34,55 @@ Because of the breaking changes in the Angular library output format, the `@cked
     <tr>
       <td colspan="3">Actively supported versions</td>
     </tr>
+    <tr>
+      <td><code>^11</code></td>
+      <td><code>19+</code></td>
+      <td>Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v47.0.0">47</a> or higher.</td>
+    </tr>
+    <tr>
+    <tr>
+      <td colspan="3">Past releases (no longer maintained)</td>
+    </tr>
+    </tr>
     <tr>
       <td><code>^10</code></td>
       <td><code>16+</code></td>
       <td>Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v46.0.0">46</a> or higher.</td>
     </tr>
     <tr>
-      <td colspan="3">Past releases (no longer maintained)</td>
-    </tr>
-	<tr>
       <td><code>^9</code></td>
       <td><code>16+</code></td>
       <td>Migration to TypeScript&nbsp;5. Declaration files are not backward compatible. Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v43.0.0">43</a> or higher.</td>
     </tr>
     <tr>
       <td><code>^8</code></td>
       <td><code>13+</code></td>
-      <td>Requires CKEditor&nbsp;5 at least in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v42.0.0">42</a>.</td>
+      <td>Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v42.0.0">42</a> or higher.</td>
     </tr>
     <tr>
       <td><code>^7</code></td>
       <td><code>13+</code></td>
-      <td>Changes in peer dependencies. (<a href="https://github.com/ckeditor/ckeditor5-angular/issues/376">issue</a>)</td>
+      <td>Changes in peer dependencies (<a href="https://github.com/ckeditor/ckeditor5-angular/issues/376">issue</a>). Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v37.0.0">37</a> or higher.</td>
     </tr>
     <tr>
       <td><code>^6</code></td>
       <td><code>13+</code></td>
-      <td>Requires CKEditor&nbsp;5 at least in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v37.0.0">37</a>.</td>
+      <td>Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v37.0.0">37</a> or higher.</td>
     </tr>
     <tr>
       <td><code>^5</code></td>
       <td><code>13+</code></td>
-      <td>Requires Angular at least in version 13+. Lower versions are no longer maintained.</td>
+      <td>Requires Angular in version 13+ or higher.</td>
     </tr>
     <tr>
       <td><code>^4</code></td>
       <td><code>9.1+</code></td>
-      <td>Requires CKEditor&nbsp;5 at least in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v34.0.0">34</a>.</td>
+      <td>Requires CKEditor&nbsp;5 in version <a href="https://github.com/ckeditor/ckeditor5/releases/tag/v34.0.0">34</a> or higher.</td>
     </tr>
     <tr>
       <td><code>^3</code></td>
       <td><code>9.1+</code></td>
-      <td>Requires Node.js at least in version 14.</td>
+      <td>Requires Node.js in version 14 or higher.</td>
     </tr>
     <tr>
       <td><code>^2</code></td>
@@ -85,7 +92,7 @@ Because of the breaking changes in the Angular library output format, the `@cked
     <tr>
       <td><code>^1</code></td>
       <td><code>5.x&nbsp;-&nbsp;8.x</code></td>
-      <td>Angular versions are no longer maintained.</td>
+      <td>Angular versions no longer maintained.</td>
     </tr>
   </tbody>
 </table>

angular.json

@@ -14,13 +14,16 @@
       "schematics": {},
       "architect": {
         "build": {
-          "builder": "@angular-devkit/build-angular:browser",
+          "builder": "@angular-devkit/build-angular:application",
           "options": {
             "aot": true,
-            "outputPath": "dist/ckeditor5-angular",
+            "outputPath": {
+              "base": "dist/ckeditor5-angular"
+            },
             "index": "src/index.html",
-            "main": "src/main.ts",
-            "polyfills": "src/polyfills.ts",
+            "polyfills": [
+              "src/polyfills.ts"
+            ],
             "tsConfig": "tsconfig.app.json",
             "assets": [
               "src/favicon.ico",
@@ -31,7 +34,8 @@
               "src/styles.css"
             ],
             "scripts": [],
-            "preserveSymlinks": true
+            "preserveSymlinks": true,
+            "browser": "src/main.ts"
           },
           "configurations": {
             "production": {
@@ -52,27 +56,25 @@
               "sourceMap": false,
               "namedChunks": false,
               "aot": true,
-              "extractLicenses": true,
-              "vendorChunk": false,
-              "buildOptimizer": true
+              "extractLicenses": true
             }
           }
         },
         "serve": {
           "builder": "@angular-devkit/build-angular:dev-server",
           "options": {
-            "browserTarget": "ckeditor5-angular:build"
+            "buildTarget": "ckeditor5-angular:build"
           },
           "configurations": {
             "production": {
-              "browserTarget": "ckeditor5-angular:build:production"
+              "buildTarget": "ckeditor5-angular:build:production"
             }
           }
         },
         "extract-i18n": {
           "builder": "@angular-devkit/build-angular:extract-i18n",
           "options": {
-            "browserTarget": "ckeditor5-angular:build"
+            "buildTarget": "ckeditor5-angular:build"
           }
         },
         "test": {
@@ -96,6 +98,5 @@
         }
       }
     }
-  },
-  "defaultProject": "ckeditor5-angular"
+  }
 }

eslint.config.mjs

@@ -35,7 +35,11 @@ export default defineConfig( [
 			'@typescript-eslint': tsPlugin.plugin
 		},
 
-		files: [ '**/*.ts' ],
+		files: [
+			'**/*.ts',
+			'**/*.mjs',
+			'**/*.js'
+		],
 
 		rules: {
 			'new-cap': 'off',

karma.conf.js

@@ -66,6 +66,17 @@ module.exports = function( config ) {
 			CHROME_LOCAL: {
 				base: 'Chrome',
 				flags: [ '--disable-background-timer-throttling' ]
+			},
+			CHROME_HEADLESS_WSL: {
+				base: 'ChromeHeadless',
+				flags: [
+					'--no-sandbox',
+					'--disable-gpu',
+					'--disable-dev-shm-usage',
+					'--disable-software-rasterizer',
+					'--disable-features=TranslateUI',
+					'--remote-debugging-port=9223'
+				]
 			}
 		},
 		singleRun: false
@@ -82,5 +93,25 @@ function getBrowsers() {
 		];
 	}
 
+	if ( isWsl() ) {
+		return [ 'CHROME_HEADLESS_WSL' ];
+	}
+
 	return [ 'CHROME_LOCAL' ];
 }
+
+function isWsl() {
+	if ( process.platform !== 'linux' ) {
+		return false;
+	}
+
+	if ( process.env.WSL_DISTRO_NAME ) {
+		return true;
+	}
+
+	if ( process.env.WSL_INTEROP ) {
+		return true;
+	}
+
+	return false;
+}

package.json

@@ -20,34 +20,34 @@
     "release:publish-packages": "node scripts/publishpackages.mjs"
   },
   "dependencies": {
-    "@angular/animations": "^16",
-    "@angular/common": "^16",
-    "@angular/compiler": "^16",
-    "@angular/core": "^16",
-    "@angular/forms": "^16",
-    "@angular/platform-browser": "^16",
-    "@angular/platform-browser-dynamic": "^16",
-    "@angular/router": "^16",
+    "@angular/animations": "^19.2.15",
+    "@angular/common": "^19.2.15",
+    "@angular/compiler": "^19.2.15",
+    "@angular/core": "^19.2.15",
+    "@angular/forms": "^19.2.15",
+    "@angular/platform-browser": "^19.2.15",
+    "@angular/platform-browser-dynamic": "^19.2.15",
+    "@angular/router": "^19.2.15",
     "@ckeditor/ckeditor5-integrations-common": "^2.2.2",
     "core-js": "^3.21.1",
     "rxjs": "^6.5.5",
     "tslib": "^2.0.3",
-    "zone.js": "~0.13.0"
+    "zone.js": "~0.15.1"
   },
   "devDependencies": {
-    "@angular-devkit/build-angular": "^16",
-    "@angular/cli": "^16",
-    "@angular/compiler-cli": "^16",
-    "@angular/language-service": "^16",
+    "@angular-devkit/build-angular": "^19.2.19",
+    "@angular/cli": "^19.2.19",
+    "@angular/compiler-cli": "^19.2.15",
+    "@angular/language-service": "^19.2.15",
     "@ckeditor/ckeditor5-dev-bump-year": "^54.0.0",
     "@ckeditor/ckeditor5-dev-changelog": "^54.0.0",
     "@ckeditor/ckeditor5-dev-ci": "^54.0.0",
     "@ckeditor/ckeditor5-dev-release-tools": "^54.0.0",
     "@ckeditor/ckeditor5-dev-utils": "^54.0.0",
     "@types/jasminewd2": "^2.0.10",
     "@types/node": "^14.11.8",
-    "ckeditor5": "^46.0.0",
-    "ckeditor5-premium-features": "^46.0.0",
+    "ckeditor5": "^47.0.0",
+    "ckeditor5-premium-features": "^47.0.0",
     "css-loader": "^5.2.7",
     "cypress": "^13.17.0",
     "eslint": "^9.38.0",
@@ -66,15 +66,15 @@
     "karma-jasmine-html-reporter": "^1.7.0",
     "lint-staged": "^10.4.0",
     "minimist": "^1.2.8",
-    "ng-packagr": "^16",
+    "ng-packagr": "^19.2.2",
     "postcss-loader": "^4.3.0",
     "raw-loader": "^4.0.1",
     "semver": "^7",
     "start-server-and-test": "^2.0.3",
     "style-loader": "^2.0.0",
     "ts-loader": "^9.4.3",
     "ts-node": "^9.0.0",
-    "typescript": "~5.0.0",
+    "typescript": "~5.5.0",
     "typescript-eslint": "^8.32.0",
     "upath": "^2.0.1",
     "webpack": "^5.94.0",