umberto 7.0.1 → 8.0.0

package/themes/umberto/src/gloria/js/_codeswitcherbuttons.js

@@ -1,146 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-import $ from 'jquery';
-
-const type = {
-	selfHosted: 'selfhosted',
-	cloud: 'cloud'
-};
-const storageSwitcherKey = 'code-switcher-type';
-const buttonClass = 'code-switcher__button';
-const buttonActiveClass = 'code-switcher__button--active';
-const codeSwitcherClass = 'code-switcher';
-const codeSwitcherToolbarClass = 'code-switcher__toolbar';
-
-function switchSnippetContent( originalSnippetContent, newType ) {
-	let newSnippetContent;
-	const gplComment = ' // Or \'GPL\'.';
-	const licenseKey = 'licenseKey: \'<YOUR_LICENSE_KEY>\',';
-
-	if ( newType === type.cloud ) {
-		newSnippetContent = originalSnippetContent
-			.replace( /import {/g, 'const {' )
-			.replace( /} from/g, '} =' )
-			.replace( /'ckeditor5';/g, 'CKEDITOR;' )
-			.replace( /'ckeditor5-premium-features'/g, 'CKEDITOR_PREMIUM_FEATURES' )
-			.replace( `${ licenseKey }${ gplComment }`, licenseKey );
-	} else if ( newType === type.selfHosted ) {
-		newSnippetContent = originalSnippetContent
-			.replace( /const {/g, 'import {' )
-			.replace( /} =/g, '} from' )
-			.replace( /CKEDITOR;/g, '\'ckeditor5\';' )
-			.replace( /CKEDITOR_PREMIUM_FEATURES/g, '\'ckeditor5-premium-features\'' )
-			.replace( licenseKey, ( match, _, wholeString ) => {
-				if ( wholeString.includes( gplComment ) ) {
-					return match;
-				} else {
-					return `${ match }${ gplComment }`;
-				}
-			} );
-	}
-
-	return newSnippetContent;
-}
-
-function switchSnippet( switcher, newType ) {
-	const codeElement = switcher.querySelector( 'pre code' );
-
-	codeElement.textContent = switchSnippetContent( codeElement.textContent, newType );
-	window.Prism.highlightElement( codeElement );
-
-	const switcherClasses = switcher.classList;
-
-	switcher.classList.replace( switcherClasses[ switcherClasses.length - 1 ], newType );
-}
-
-function saveSnippetType( type ) {
-	if ( type === getSnippetType() ) {
-		return;
-	}
-
-	localStorage.setItem( storageSwitcherKey, type );
-	window.dispatchEvent( new Event( 'storage' ) );
-}
-
-function getSnippetType() {
-	return localStorage.getItem( storageSwitcherKey );
-}
-
-function createButton( label, isActive = false ) {
-	const button = document.createElement( 'button' );
-
-	button.textContent = label;
-	button.classList.add( buttonClass );
-
-	if ( isActive ) {
-		button.classList.add( buttonActiveClass );
-	}
-
-	return button;
-}
-
-export function createCodeSwitcherButtons() {
-	const switchers = document.querySelectorAll( `.${ codeSwitcherClass }` );
-
-	if ( switchers.lenght === 0 ) {
-		return;
-	}
-
-	const savedType = getSnippetType();
-
-	switchers.forEach( switcher => {
-		if ( savedType ) {
-			switchSnippet( switcher, savedType );
-		}
-
-		const activeType = switcher.classList[ switcher.classList.length - 1 ];
-
-		const selfHostedButton = createButton( 'Self-hosted (npm)', activeType === type.selfHosted );
-
-		selfHostedButton.setAttribute( 'title', 'Show import snippets for npm and ZIP setups.' );
-
-		const cloudButton = createButton( 'Cloud (CDN)', activeType === type.cloud );
-
-		cloudButton.setAttribute( 'title', 'Show import snippets for a CDN setup.' );
-
-		const switcherToolbar = switcher.querySelector( `.${ codeSwitcherToolbarClass }` );
-
-		switcherToolbar.append( selfHostedButton );
-		switcherToolbar.append( cloudButton );
-		switcher.prepend( switcherToolbar );
-
-		window.addEventListener( 'storage', () => {
-			const savedType = getSnippetType();
-
-			if ( savedType ) {
-				switchSnippet( switcher, savedType );
-
-				if ( savedType === type.selfHosted ) {
-					selfHostedButton.classList.add( buttonActiveClass );
-					cloudButton.classList.remove( buttonActiveClass );
-				} else if ( savedType === type.cloud ) {
-					cloudButton.classList.add( buttonActiveClass );
-					selfHostedButton.classList.remove( buttonActiveClass );
-				}
-			}
-		} );
-
-		selfHostedButton.addEventListener( 'click', () => {
-			saveSnippetType( type.selfHosted );
-		} );
-		cloudButton.addEventListener( 'click', () => {
-			saveSnippetType( type.cloud );
-		} );
-	} );
-
-	/* eslint-disable max-len */
-	const infoCircle = $( `
-		<svg class="code-switcher__info" width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
-			<path d="M6 0.75C3.10078 0.75 0.75 3.10078 0.75 6C0.75 8.89922 3.10078 11.25 6 11.25C8.89922 11.25 11.25 8.89922 11.25 6C11.25 3.10078 8.89922 0.75 6 0.75ZM6 10.3594C3.59297 10.3594 1.64063 8.40703 1.64063 6C1.64063 3.59297 3.59297 1.64063 6 1.64063C8.40703 1.64063 10.3594 3.59297 10.3594 6C10.3594 8.40703 8.40703 10.3594 6 10.3594Z" fill="white"/>
-			<path d="M5.43732 3.9375C5.43732 4.08668 5.49658 4.22976 5.60207 4.33525C5.70756 4.44074 5.85063 4.5 5.99982 4.5C6.149 4.5 6.29207 4.44074 6.39756 4.33525C6.50305 4.22976 6.56232 4.08668 6.56232 3.9375C6.56232 3.78832 6.50305 3.64524 6.39756 3.53975C6.29207 3.43426 6.149 3.375 5.99982 3.375C5.85063 3.375 5.70756 3.43426 5.60207 3.53975C5.49658 3.64524 5.43732 3.78832 5.43732 3.9375ZM6.28107 5.25H5.71857C5.667 5.25 5.62482 5.29219 5.62482 5.34375V8.53125C5.62482 8.58281 5.667 8.625 5.71857 8.625H6.28107C6.33263 8.625 6.37482 8.58281 6.37482 8.53125V5.34375C6.37482 5.29219 6.33263 5.25 6.28107 5.25Z" fill="white"/>
-		</svg>` );
-	infoCircle.appendTo( `.${ buttonClass }` );
-}

package/themes/umberto/src/gloria/js/_collapsables.js

@@ -1,135 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-import $ from 'jquery';
-
-const classExp = 'toggler--expanded';
-const classCol = 'toggler--collapsed';
-
-export function enableCollapsables() {
-	enableCollapsable( {
-		selector: '.tree li[class*="toggler--"]',
-		nodeElement: 'li',
-		dontToggleClass: 'tree__item__text',
-
-		collapsedClass: classCol,
-		expandedClass: classExp
-	} );
-
-	enableCollapsable( {
-		selector: '.collapsing-list__term[class*="toggler--"]',
-		nodeElement: '.collapsing-list__term',
-		dontToggleClass: [ 'collapsing-list__type', 'collapsing-list__dev-names--active' ],
-
-		collapsedClass: classCol,
-		expandedClass: classExp
-	} );
-}
-
-function enableCollapsable( options ) {
-	$( options.selector ).on( 'click', function( evt ) {
-		const clicked = $( this );
-		const target = $( evt.target );
-		const parentNode = target.closest( options.nodeElement );
-
-		if ( parentNode.is( options.selector ) ) {
-			if ( hasClassFrom( target, 'hidden' ) || hasClassFrom( target.parent(), 'hidden' ) ) {
-				return;
-			}
-
-			if ( ( target.is( 'a' ) || target.is( 'code' ) ) && hasClassFrom( target, options.dontToggleClass ) ) {
-				return;
-			}
-
-			clicked.toggleClass( `${ options.expandedClass } ${ options.collapsedClass }` );
-			evt.stopPropagation();
-		}
-	} );
-
-	function hasClassFrom( target, classArray ) {
-		let ret = false;
-		if ( typeof classArray === 'string' ) {
-			return target.hasClass( classArray );
-		}
-		classArray.forEach( cls => {
-			if ( target.hasClass( cls ) ) {
-				ret = true;
-			}
-		} );
-		return ret;
-	}
-}
-
-export function hideTogglers() {
-	$( '.collapsing-list__item' ).each( function() {
-		const item = $( this );
-		const excerpt = item.find( '.collapsing-list__excerpt' );
-		const hasExcerpt = excerpt.length > 0;
-
-		if ( hasExcerpt ) {
-			hideTogglersWithExcerpts( item );
-		} else {
-			hideTogglersWithoutExcerpts( item );
-		}
-	} );
-}
-
-function hideTogglersWithoutExcerpts( item ) {
-	const hasDescription = item.find( '.collapsing-list__description' ).length > 0;
-
-	// Items without description have no togglers in the first place.
-	if ( !hasDescription ) {
-		const term = item.children( '.collapsing-list__term' );
-		term.addClass( 'collapsing-list__term--no-excerpt' );
-
-		return;
-	}
-
-	// Check whether there is any content in the extended description.
-	const hasContent = item.find( '.collapsing-list__content' ).text().trim().length > 0;
-
-	// Check whether there is a link to the source code.
-	const hasSourceLink = item.find( '.see-source' ).length > 0;
-
-	// If none of the criteria above is met, toggler is not needed and can be hidden away.
-	if ( !hasContent && !hasSourceLink ) {
-		hideTogglerForItem( item );
-	}
-}
-
-function hideTogglersWithExcerpts( item ) {
-	const isExcerptShort = item.find( '.collapsing-list__excerpt--short' ).length > 0;
-
-	// Short excerpts have no togglers in the first place.
-	if ( isExcerptShort ) {
-		return;
-	}
-
-	// Check whether short description is cut off by an ellipsis due to available space being too narrow.
-	const excerptParagraph = item.find( '.collapsing-list__excerpt p' );
-	// Some elements have no short description, eg.:
-	// api/module_basic-styles_attributecommand-AttributeCommand.html#function-constructor
-	const excerptHasEllipsis = !excerptParagraph.length ? false :
-		Math.abs( excerptParagraph[ 0 ].clientWidth - excerptParagraph[ 0 ].scrollWidth ) > 0;
-
-	// Check whether there is any content in the extended description.
-	const hasContent = item.find( '.collapsing-list__content' ).text().trim().length > 0;
-
-	// Check whether there is a link to the source code.
-	const hasSourceLink = item.find( '.see-source' ).length > 0;
-
-	// If none of the criteria above is met, toggler is not needed and can be hidden away.
-	if ( !excerptHasEllipsis && !hasContent && !hasSourceLink ) {
-		hideTogglerForItem( item );
-	}
-}
-
-function hideTogglerForItem( item ) {
-	const term = item.children( '.collapsing-list__term' );
-
-	term.removeClass( classCol );
-	term.addClass( classExp );
-	term.addClass( 'hidden' );
-}

package/themes/umberto/src/gloria/js/_copymobileapinavigation.js

@@ -1,26 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-export default function copyMobileApiNavigation() {
-	// First check if it is API page.
-	const apiTree = document.querySelector( '.side-navigation__inner--api' );
-
-	if ( !apiTree ) {
-		return;
-	}
-
-	// Check current project.
-	const currentProject = document.querySelector( 'header.top' ).dataset.project;
-
-	// copy there API tree
-	const mobileApiMenu = document.querySelector(
-		`.header__menu-rwd__projects li[ data-project=${ currentProject } ] li[ data-group=api-reference ]`
-	);
-
-	// Clone HTML Element with API Tree.
-	const clonedApiTree = apiTree.firstElementChild.cloneNode( true );
-
-	mobileApiMenu.appendChild( clonedApiTree );
-}

package/themes/umberto/src/gloria/js/_devnames.js

@@ -1,37 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-export function activateDevNames() {
-	const elements = Array.from( document.querySelectorAll( '.collapsing-list__dev-names > code' ) );
-	const clsName = 'collapsing-list__dev-names--active';
-	const lsDevName = 'umberto:devnames';
-
-	document.addEventListener( 'keypress', evt => {
-		if ( !evt.shiftKey || evt.key.toUpperCase() !== 'D' ) {
-			return;
-		}
-		toggleDevNames( elements );
-	} );
-
-	if ( window.localStorage.getItem( lsDevName ) === 'true' ) {
-		elements.forEach( element => {
-			element.classList.add( clsName );
-		} );
-	}
-
-	function toggleDevNames( elements ) {
-		if ( window.localStorage.getItem( lsDevName ) === 'true' ) {
-			elements.forEach( element => {
-				element.classList.remove( clsName );
-			} );
-			window.localStorage.setItem( lsDevName, 'false' );
-		} else {
-			elements.forEach( element => {
-				element.classList.add( clsName );
-			} );
-			window.localStorage.setItem( lsDevName, 'true' );
-		}
-	}
-}

package/themes/umberto/src/gloria/js/_dropdowns.js

@@ -1,55 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-import $ from 'jquery';
-
-export function enableDropdowns() {
-	const activeClass = 'dropdown--active';
-	const doc = $( document );
-
-	$( '.dropdown__button' ).each( function( index, button ) {
-		const dropdown = $( button ).parent();
-
-		$( button ).on( 'click', toggleDropdown );
-
-		function startListening() {
-			doc.on( 'click', closeDropdownOnClick );
-			doc.on( 'keyup', closeDropdownOnEsc );
-		}
-
-		function stopListening() {
-			doc.off( 'click', closeDropdownOnClick );
-			doc.off( 'keyup', closeDropdownOnEsc );
-		}
-
-		function closeDropdownOnClick( evt ) {
-			const target = evt.target;
-
-			if ( !( dropdown.has( target ).length || dropdown.is( target ) ) ) {
-				dropdown.removeClass( activeClass );
-
-				stopListening();
-			}
-		}
-
-		function closeDropdownOnEsc( evt ) {
-			if ( evt.keyCode === 27 ) {
-				dropdown.removeClass( activeClass );
-
-				stopListening();
-			}
-		}
-
-		function toggleDropdown() {
-			dropdown.toggleClass( activeClass );
-
-			if ( dropdown.hasClass( activeClass ) ) {
-				startListening();
-			} else {
-				stopListening();
-			}
-		}
-	} );
-}

package/themes/umberto/src/gloria/js/_filtering.js

@@ -1,139 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-import $ from 'jquery';
-
-export function enableFiltering() {
-	const storagePrefix = 'filtering:props:';
-	const filterStorageKeys = {
-		public: storagePrefix + 'public',
-		inherited: storagePrefix + 'inherited',
-		internal: storagePrefix + 'internal',
-		protected: storagePrefix + 'protected',
-		private: storagePrefix + 'private',
-		deprecated: storagePrefix + 'deprecated',
-		tree: 'filtering:tree'
-	};
-
-	enablePropertiesFiltering();
-	enableTreeFiltering();
-
-	function enablePropertiesFiltering() {
-		$( '.api-props-filter input' )
-			.on( 'change', applyFilterConfig )
-			.on( 'change', saveFilterSetting );
-
-		function getFilterConfig() {
-			return $( '.api-props-filter input' ).map( function( index, domInput ) {
-				if ( domInput.checked ) {
-					return $( domInput ).val();
-				}
-			} );
-		}
-
-		function applyFilterConfig() {
-			const cfg = getFilterConfig().toArray();
-			const visibleClass = 'collapsing-list__item--visible';
-			const hiddenLoadingClass = 'hidden-loading';
-			const emptyClass = 'collapsing-list--empty';
-			const firstItemClass = 'collapsing-list__item--first';
-			const dropdownHiddenClass = 'api-subheader__navigation-dropdown--hidden';
-
-			$( '.loading' ).addClass( hiddenLoadingClass );
-			$( `.main__content--api .${ hiddenLoadingClass }:not(.loading)` ).removeClass( hiddenLoadingClass );
-
-			$( `.collapsing-list__item.${ visibleClass }` ).removeClass( `${ visibleClass } ${ firstItemClass }` );
-			$( '.collapsing-list' ).removeClass( emptyClass );
-
-			$( '.collapsing-list__item' ).each( function() {
-				const data = $( this ).data();
-
-				for ( const key in data ) {
-					if ( Object.prototype.hasOwnProperty.call( data, key ) && data[ key ] === true && cfg.indexOf( key ) === -1 ) {
-						return;
-					}
-				}
-
-				$( this ).addClass( visibleClass );
-			} );
-
-			$( '.collapsing-list' ).filter( function() {
-				return $( this ).children( ':visible' ).length === 0;
-			} ).each( function() {
-				$( this ).addClass( emptyClass );
-			} );
-
-			$( '.collapsing-list' ).each( function() {
-				$( this ).children( ':visible' ).first().addClass( firstItemClass );
-			} );
-
-			$( `.api-subheader__navigation-dropdown > li.${ dropdownHiddenClass }` ).removeClass( dropdownHiddenClass );
-			$( '.api-subheader__navigation-dropdown > li' ).each( function() {
-				const data = $( this ).data();
-				for ( const key in data ) {
-					if ( Object.prototype.hasOwnProperty.call( data, key ) && data[ key ] === true && cfg.indexOf( key ) === -1 ) {
-						$( this ).addClass( dropdownHiddenClass );
-					}
-				}
-			} );
-
-			// Refresh dropdown classes and visibility
-			window.umberto.updateDropdowns();
-		}
-
-		function saveFilterSetting() {
-			const type = $( this ).val();
-			const checked = $( this ).prop( 'checked' );
-
-			window.localStorage.setItem( filterStorageKeys[ type ], checked );
-		}
-
-		function applySavedFilterSettings() {
-			$( '.api-props-filter input' ).each( function() {
-				const type = $( this ).val();
-				const stored = window.localStorage.getItem( filterStorageKeys[ type ] );
-
-				if ( stored !== null ) {
-					$( this ).prop( 'checked', JSON.parse( stored ) );
-				}
-			} );
-		}
-
-		applySavedFilterSettings();
-		applyFilterConfig();
-	}
-
-	function enableTreeFiltering() {
-		const input = $( '.api-tree__filter input' );
-		const showPrivateClass = 'api-tree--show-private';
-		const tree = $( '.api-tree' );
-		const stored = window.localStorage.getItem( filterStorageKeys.tree );
-
-		if ( input && input.length === 0 ) {
-			return;
-		}
-
-		input
-			.on( 'change', applyTreeFilter )
-			.on( 'change', function() {
-				const checked = $( this ).prop( 'checked' );
-				window.localStorage.setItem( filterStorageKeys.tree, checked );
-			} );
-
-		function applyTreeFilter() {
-			if ( input.get( 0 ).checked ) {
-				tree.addClass( showPrivateClass );
-			} else {
-				tree.removeClass( showPrivateClass );
-			}
-		}
-
-		if ( stored !== null ) {
-			input.prop( 'checked', JSON.parse( stored ) );
-		}
-
-		applyTreeFilter();
-	}
-}

package/themes/umberto/src/gloria/js/_pagenavigation.js

@@ -1,93 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-export default function pageNavigation() {
-	const CLASS_NAMES = {
-		huge: 'api-subheader__navigation-dropdown--huge',
-		big: 'api-subheader__navigation-dropdown--big',
-		small: 'api-subheader__navigation-dropdown--small',
-		empty: 'api-subheader__navigation-dropdown--empty',
-		hidden: 'api-subheader__navigation-dropdown--hidden'
-	};
-	const mainNavigationElements = document.querySelectorAll( '.api-subheader__navigation > ul > li' );
-	for ( const element of mainNavigationElements ) {
-		const ul = createListFor( element );
-
-		element.appendChild( ul );
-	}
-
-	if ( !window.umberto ) {
-		window.umberto = {};
-	}
-
-	window.umberto.updateDropdowns = function updateDropdowns() {
-		for ( const element of mainNavigationElements ) {
-			const ul = element.querySelector( 'ul' );
-			const visibleItemsLength = ul.querySelectorAll( 'li:not(.api-subheader__navigation-dropdown--hidden)' ).length;
-			if ( !visibleItemsLength ) {
-				element.classList.add( CLASS_NAMES.hidden );
-			} else {
-				element.classList.remove( CLASS_NAMES.hidden );
-				setClass( ul, dropdownLengthType( visibleItemsLength ) );
-			}
-		}
-	};
-
-	function createListFor( element ) {
-		const links = getLinksFor( element );
-		const ul = document.createElement( 'ul' );
-
-		ul.classList.add( 'api-subheader__navigation-dropdown' );
-		ul.classList.add( dropdownLengthType( links.length ) );
-
-		for ( const link of links ) {
-			ul.appendChild( link );
-		}
-
-		return ul;
-	}
-
-	function getLinksFor( element ) {
-		const outputList = [];
-		const lists = document.querySelectorAll( 'ul[data-type=' + element.dataset.type + ']' );
-		for ( const list of lists ) {
-			const links = list.querySelectorAll( 'li.collapsing-list__item' );
-			for ( const link of links ) {
-				const listItem = document.createElement( 'li' );
-				const clonedLink = link.querySelector( 'h3 a.member-name' ).cloneNode( true );
-				clonedLink.classList.add( 'api-subheader__navigation-link' );
-				listItem.appendChild( clonedLink );
-				Object.assign( listItem.dataset, link.dataset );
-				outputList.push( listItem );
-			}
-		}
-		return outputList;
-	}
-
-	function dropdownLengthType( elements ) {
-		if ( elements > 60 ) {
-			return CLASS_NAMES.huge;
-		} else if ( elements > 20 ) {
-			return CLASS_NAMES.big;
-		} else if ( elements > 0 ) {
-			return CLASS_NAMES.small;
-		} else {
-			return CLASS_NAMES.empty;
-		}
-	}
-
-	function setClass( element, className ) {
-		if ( !element.classList.contains( className ) ) {
-			element.classList.add( className );
-		}
-
-		for ( const cls in CLASS_NAMES ) {
-			if ( CLASS_NAMES[ cls ] !== className ) {
-				element.classList.remove( CLASS_NAMES[ cls ] );
-			}
-		}
-	}
-}
-