umberto 8.3.1 → 8.3.3

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 Changelog
 =========
 
+## [8.3.3](https://github.com/cksource/umberto/compare/v8.3.2...v8.3.3) (October 15, 2025)
+
+### Bug fixes
+
+* Link validator should not fail on links containing the word "latest", if they are not part of a version number.
+* Fixed links being unstyled in Kapa.ai answers.
+* Fix broken page sidebar layout on `959px` resolution.
+
+
+## [8.3.2](https://github.com/cksource/umberto/compare/v8.3.1...v8.3.2) (September 16, 2025)
+
+### Other changes
+
+* Update to TypeScript 5.3.
+
+
 ## [8.3.1](https://github.com/cksource/umberto/compare/v8.3.0...v8.3.1) (September 4, 2025)
 
 ### Bug fixes
@@ -28,24 +44,6 @@ Changelog
 
   Umberto configuration can now specify the `kapa` key that allows loading the Kapa button and widget.
 
-
-## [8.1.0](https://github.com/cksource/umberto/compare/v8.0.3...v8.1.0) (August 12, 2025)
-
-### Features
-
-* Added support for relative paths in `packagesDir` option.
-
-### Bug fixes
-
-* Updated how `<iframe>` elements are created to fix issues with automated tests using Chrome v139.
-
-
-## [8.0.3](https://github.com/cksource/umberto/compare/v8.0.2...v8.0.3) (August 5, 2025)
-
-### Bug fixes
-
-* The backticks in the XML components parser were not escaped correctly, causing issues with parsing XML content. This fix ensures that backticks are properly escaped, allowing the parser to handle XML content containing backticks without errors.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/README.md

@@ -1,9 +1,14 @@
 # Umberto
 
 ## Installation
-`npm install umberto`
+
+> [!NOTE]
+> This project requires **pnpm v10** or higher. You can check your version with `pnpm --version` and update if needed with `npm install -g pnpm@latest`.
+
+`pnpm install -D umberto`
 
 ## Building documentation of a single project
+
 Note: The only documentation type supported at the moment is JSDoc.
 
 **Step 1:** Create the `umberto.json` configuration file in the project's root directory or in the `docs` directory. This file will tell Umberto how to build documentation for this project.
@@ -230,10 +235,10 @@ For the example above, project-logo.svg should be located in common files direct
 
 ```
 cd umberto
-npm link            # Creates a global link.
+pnpm link --global          # Creates a global link.
 
 cd ../bigbang-docs.ckeditor.com
-npm link umberto    # link-install the package
+pnpm link umberto           # link-install the package
 ```
 
 ## Shortcuts
@@ -870,7 +875,7 @@ Before you start, you need to prepare the changelog entries.
 
 1. Make sure the `#master` branch is up-to-date: `git fetch && git checkout master && git pull`.
 1. Prepare a release branch: `git checkout -b release-[YYYYMMDD]` where `YYYYMMDD` is the current day.
-1. Generate the changelog entries: `yarn run release:prepare-changelog`.
+1. Generate the changelog entries: `pnpm run release:prepare-changelog`.
    * You can specify the release date by passing the `--date` option, e.g., `--date=2025-06-11`.
    * By passing the `--dry-run` option, you can check what the script will do without actually modifying the files.
    * Read all the entries, correct poor wording and other issues, wrap code names in backticks to format them, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "8.3.1",
+  "version": "8.3.3",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "files": [
@@ -53,7 +53,9 @@
     "webpack": "^5.94.0"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.0.0",
+    "pnpm": ">=10.14.0",
+    "yarn": "\n\n┌─────────────────────────┐\n│  Hey, we use pnpm now!  │\n└─────────────────────────┘\n\n"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "MIT",

package/src/tasks/validate-links.js

@@ -102,12 +102,12 @@ function validateChunk( { chunk, links, options } ) {
 				continue;
 			}
 
-			if ( resolvedPath.includes( 'latest' ) ) {
+			if ( resolvedPath.includes( '/latest/' ) ) {
 				const projectInfo = options.projectsInfo ?
 					options.projectsInfo.find( i => resolvedPath.includes( `/${ i.slug }/` ) ) :
 					null;
 				const projectVersion = projectInfo ? projectInfo.version : 'latest';
-				resolvedPath = resolvedPath.replace( 'latest', projectVersion );
+				resolvedPath = resolvedPath.replace( '/latest/', `/${ projectVersion }/` );
 			}
 
 			if ( options.projectsInfo ) {

package/themes/umberto/layout/gloria/_modules/kapa/custom_kapa_styles.css

@@ -11,11 +11,8 @@
 
 /* Style for hyperlinks inside the AI's answer. */
 #kapa-modal-content
-	> div:nth-of-type(1)
-	> div:nth-of-type(1)
-	> div:nth-of-type(1)
-	> div:nth-of-type(2)
-	> h5 + div
+	.scrollable-container
+	.mantine-Title-root + div
 	a
 {
 	font-weight: normal !important;

package/themes/umberto/src/gloria/css/layout/_mixins.scss

@@ -10,7 +10,7 @@ $breakpoint-xl: 1920px;
 }
 
 @mixin min-width($breakpoint) {
-    @media (min-width: calc(#{$breakpoint} - 1px)) {
+    @media (min-width: calc(#{$breakpoint})) {
         @content;
     }
 }