umberto 10.4.1 → 10.5.0

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 Changelog
 =========
 
+## [10.5.0](https://github.com/cksource/umberto/compare/v10.4.1...v10.5.0) (April 14, 2026)
+
+### Features
+
+* Added the Call for feedback component for documentation pages.
+
+
 ## [10.4.1](https://github.com/cksource/umberto/compare/v10.4.0...v10.4.1) (April 13, 2026)
 
 ### Bug fixes
@@ -40,13 +47,6 @@ Changelog
 * Added cyan LTS banner at the top of the page on LTS branch.
 * Updated the colour of nightly banner to yellow.
 
-
-## [10.1.4](https://github.com/cksource/umberto/compare/v10.1.3...v10.1.4) (March 20, 2026)
-
-### Other changes
-
-* Filter search results from Algolia to match the current docs version: `latest` or `lts-v47`. Filtering remains backward-compatible: hits without the docs version are still allowed.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "10.4.1",
+  "version": "10.5.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",

package/scripts/filter/after-post-render/gloria/validate-call-for-feedback-once.cjs

@@ -0,0 +1,24 @@
+/**
+ * @license Copyright (c) 2017-2026, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+const countCallForFeedbackBlocks = require( '../../../utils/count-call-for-feedback-blocks.cjs' );
+
+hexo.extend.filter.register( 'after_post_render', page => {
+	if ( page.projectTheme !== 'gloria' || typeof page.content !== 'string' ) {
+		return page;
+	}
+
+	const count = countCallForFeedbackBlocks( page.content );
+
+	if ( count > 1 ) {
+		throw new Error(
+			`Call for feedback: expected at most one <ck:call-for-feedback /> per page, found ${ count } in ${ page.source }.`
+		);
+	}
+
+	return page;
+}, 47 );

package/scripts/filter/before-post-render/gloria/prerender-xml-pug-components.cjs

@@ -144,6 +144,16 @@ const PATTERN_ELEMENTS = [
 		]
 	},
 
+	// Call for feedback
+	{
+		pattern: /^(?:ck:)?call-for-feedback$/,
+		mixinName: 'call-for-feedback',
+		allowMarkdownContent: false,
+		requires: [
+			'_components/call-for-feedback/index'
+		]
+	},
+
 	// Labels
 	{
 		pattern: /(?:ck:)?snippet-footer$/,

package/scripts/utils/count-call-for-feedback-blocks.cjs

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2017-2026, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+const { parseDocument } = require( 'htmlparser2' );
+const { selectAll } = require( 'css-select' );
+
+/**
+ * Counts rendered Call for feedback blocks (`aside.c-call-for-feedback`) in HTML.
+ *
+ * @param {string} html
+ * @returns {number}
+ */
+function countCallForFeedbackBlocks( html ) {
+	if ( !html || typeof html !== 'string' ) {
+		return 0;
+	}
+
+	const doc = parseDocument( html );
+
+	return selectAll( 'aside.c-call-for-feedback', doc ).length;
+}
+
+module.exports = countCallForFeedbackBlocks;

package/themes/umberto/layout/gloria/_components/call-for-feedback/_style.scss

@@ -0,0 +1,47 @@
+.c-call-for-feedback {
+	box-sizing: border-box;
+	display: flex;
+	flex-direction: column;
+	align-items: flex-start;
+	gap: var(--spacing-2);
+	margin: var(--spacing-7) 0 0;
+	padding: var(--spacing-4);
+	border: 1.5px solid var(--color-primary-300);
+	border-radius: var(--radius-1);
+	background: var(--color-common-white);
+
+	&__title {
+		margin: 0;
+		font-family: var(--font-family-heading);
+		font-size: var(--font-size-lg);
+		line-height: var(--line-height-sm);
+		font-weight: var(--font-weight-bold);
+		color: var(--color-primary-500);
+	}
+
+	&__text {
+		margin: 0;
+		font-family: var(--font-family-text);
+		font-weight: var(--font-weight-thin);
+		font-size: var(--font-size-base);
+		line-height: var(--line-height-base);
+		color: var(--color-text-primary);
+	}
+
+	&__link {
+		color: var(--color-primary-500);
+		text-decoration: underline;
+		text-decoration-color: var(--color-primary-300);
+		text-underline-offset: 0.15em;
+
+		&:hover {
+			text-decoration-color: var(--color-primary-500);
+		}
+
+		&:focus-visible,
+		&:active {
+			color: var(--color-primary-600);
+			text-decoration-color: var(--color-primary-600);
+		}
+	}
+}

package/themes/umberto/layout/gloria/_components/call-for-feedback/index.pug

@@ -0,0 +1,16 @@
+//- Call for feedback component
+//-
+//- Examples:
+//- +call-for-feedback()
+//-
+//- <ck:call-for-feedback />
+//-
+//- <call-for-feedback />
+mixin call-for-feedback()
+	//- Stable id: at most one block per page (build fails if more); see validate-call-for-feedback-once.cjs.
+	aside.c-call-for-feedback( role='complementary' aria-labelledby='call-for-feedback-title' )
+		h3.c-call-for-feedback__title#call-for-feedback-title Call for feedback
+		p.c-call-for-feedback__text
+			| Have an idea for future improvements? We'd love to hear from you! Share your thoughts and suggestions with us through our&nbsp;
+			a.c-call-for-feedback__link( href='https://ckeditor.com/contact/' ) contact form
+			| .

package/themes/umberto/layout/gloria/_components/index.pug

@@ -26,6 +26,7 @@ include ./card-learn-more-links/index
 include ./card/index
 include ./skeleton/index
 include ./fake-devtools/index
+include ./call-for-feedback/index
 include ./iframe/index
 include ./tag/index
 include ./columns/index

package/themes/umberto/src/gloria/css/components/_index.scss

@@ -35,6 +35,7 @@
 		'card',
 		'skeleton',
 		'fake-devtools',
+		'call-for-feedback',
 		'iframe',
 		'tag',
 		'snippet-footer'