npm - umberto - Versions diffs - 7.0.2 → 8.0.0 - Mend

umberto 7.0.2 → 8.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (554) hide show

package/themes/umberto/src/gloria/js/helpers/identity.js ADDED Viewed

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export function identity( value ) {
+	return value;
+}

package/themes/umberto/src/gloria/js/helpers/inject-resource-preload.js ADDED Viewed

@@ -0,0 +1,51 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Appends a `<link>` element to the `<head>` to preload a resource.
+ *
+ * 	* It should detect if the resource is already preloaded.
+ * 	* It should detect type of the resource and set the `as` attribute accordingly.
+ *
+ * @param url The URL of the resource to preload.
+ * @param props Additional properties for the preload.
+ * @param props.attributes Additional attributes to be set on the `<link>` element.
+ */
+export function injectResourcePreload( url, { attributes } = {} ) {
+	if ( document.head.querySelector( `link[href="${ url }"][rel="preload"]` ) ) {
+		return;
+	}
+	const link = document.createElement( 'link' );
+	// Set additional attributes if provided.
+	for ( const [ key, value ] of Object.entries( attributes || {} ) ) {
+		link.setAttribute( key, value );
+	}
+	link.setAttribute( 'data-injected-by', 'ckeditor-docs' );
+	link.rel = 'preload';
+	link.as = detectTypeOfResource( url );
+	link.href = url;
+	document.head.insertBefore( link, document.head.firstChild );
+}
+/**
+ * Detects the type of the resource based on its URL.
+ */
+function detectTypeOfResource( url ) {
+	switch ( true ) {
+		case /\.css$/.test( url ):
+			return 'style';
+		case /\.js$/.test( url ):
+			return 'script';
+		default:
+			return 'fetch';
+	}
+}

package/themes/umberto/src/gloria/js/helpers/inject-script.js ADDED Viewed

@@ -0,0 +1,79 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Map of injected scripts. It is used to prevent injecting the same script multiple times.
+ * It happens quite often in React Strict mode when the component is rendered twice.
+ */
+const INJECTED_SCRIPTS = new Map();
+/**
+ * Injects a script into the document.
+ */
+export function injectScript( src, { attributes } = {} ) {
+	// Return the promise if the script is already injected by this function.
+	if ( INJECTED_SCRIPTS.has( src ) ) {
+		return INJECTED_SCRIPTS.get( src );
+	}
+	// Return the promise if the script is already present in the document but not injected by this function.
+	// We are not sure if the script is loaded or not, so we have to show warning in this case.
+	const maybePrevScript = document.querySelector( `script[src="${ src }"]` );
+	if ( maybePrevScript ) {
+		console.warn( `Script with "${ src }" src is already present in DOM!` );
+		maybePrevScript.remove();
+	}
+	// Inject the script and return the promise.
+	const promise = new Promise( ( resolve, reject ) => {
+		const script = document.createElement( 'script' );
+		script.onerror = reject;
+		script.onload = () => {
+			resolve();
+		};
+		// Set additional attributes if provided.
+		for ( const [ key, value ] of Object.entries( attributes || {} ) ) {
+			script.setAttribute( key, value );
+		}
+		script.setAttribute( 'data-injected-by', 'ckeditor-docs' );
+		script.type = 'text/javascript';
+		script.async = true;
+		script.src = src;
+		document.head.appendChild( script );
+		// It should remove script if script is being removed from the DOM.
+		const observer = new MutationObserver( mutations => {
+			const removedNodes = mutations.flatMap( mutation => Array.from( mutation.removedNodes ) );
+			if ( removedNodes.includes( script ) ) {
+				INJECTED_SCRIPTS.delete( src );
+				observer.disconnect();
+			}
+		} );
+		observer.observe( document.head, {
+			childList: true,
+			subtree: true
+		} );
+	} );
+	INJECTED_SCRIPTS.set( src, promise );
+	return promise;
+}
+/**
+ * Injects multiple scripts into the document in parallel.
+ */
+export async function injectScriptsInParallel( sources, props = {} ) {
+	await Promise.all(
+		sources.map( src => injectScript( src, props ) )
+	);
+}

package/themes/umberto/src/gloria/js/helpers/inject-stylesheet.js ADDED Viewed

@@ -0,0 +1,108 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Map of injected stylesheets. It's used to prevent injecting the same stylesheet multiple times.
+ * It happens quite often in React Strict mode when the component is rendered twice.
+ */
+export const INJECTED_STYLESHEETS = new Map();
+/**
+ * Injects a stylesheet into the document.
+ *
+ * @param props.href The URL of the stylesheet to be injected.
+ * @param props.placementInHead The placement of the stylesheet in the head.
+ * @param props.attributes Additional attributes to be set on the link element.
+ * @returns A promise that resolves when the stylesheet is loaded.
+ */
+export function injectStylesheet(
+	{
+		href,
+		placementInHead = 'start',
+		attributes = {}
+	}
+) {
+	// Return the promise if the stylesheet is already injected by this function.
+	if ( INJECTED_STYLESHEETS.has( href ) ) {
+		return INJECTED_STYLESHEETS.get( href );
+	}
+	// Return the promise if the stylesheet is already present in the document but not injected by this function.
+	// We are not sure if the stylesheet is loaded or not, so we have to show a warning in this case.
+	const maybePrevStylesheet = document.querySelector( `link[href="${ href }"][rel="stylesheet"]` );
+	if ( maybePrevStylesheet ) {
+		console.warn( `Stylesheet with "${ href }" href is already present in DOM!` );
+		maybePrevStylesheet.remove();
+	}
+	// Append the link tag to the head.
+	const appendLinkTagToHead = link => {
+		// Inject styles after the stylesheets that are already present in the head.
+		// Do not specify the `rel` attribute because we want to inject the stylesheet even after
+		// preloading link tags.
+		const previouslyInjectedLinks = Array.from(
+			document.head.querySelectorAll( 'link[data-injected-by="ckeditor-docs"]' )
+		);
+		switch ( placementInHead ) {
+			// It'll append styles *before* the stylesheets that are already present in the head
+			// but after the ones that are injected by this function.
+			case 'start':
+				if ( previouslyInjectedLinks.length ) {
+					previouslyInjectedLinks.slice( -1 )[ 0 ].after( link );
+				} else {
+					document.head.insertBefore( link, document.head.firstChild );
+				}
+				break;
+			// It'll append styles *after* the stylesheets already in the head.
+			case 'end':
+				document.head.appendChild( link );
+				break;
+		}
+	};
+	// Inject the stylesheet and return the promise.
+	const promise = new Promise( ( resolve, reject ) => {
+		const link = document.createElement( 'link' );
+		// Set additional attributes if provided.
+		for ( const [ key, value ] of Object.entries( attributes || {} ) ) {
+			link.setAttribute( key, value );
+		}
+		link.setAttribute( 'data-injected-by', 'ckeditor-docs' );
+		link.rel = 'stylesheet';
+		link.href = href;
+		link.onerror = reject;
+		link.onload = () => {
+			resolve();
+		};
+		appendLinkTagToHead( link );
+		// It should remove stylesheet if stylesheet is being removed from the DOM.
+		const observer = new MutationObserver( mutations => {
+			const removedNodes = mutations.flatMap( mutation => Array.from( mutation.removedNodes ) );
+			if ( removedNodes.includes( link ) ) {
+				INJECTED_STYLESHEETS.delete( href );
+				observer.disconnect();
+			}
+		} );
+		observer.observe( document.head, {
+			childList: true,
+			subtree: true
+		} );
+	} );
+	INJECTED_STYLESHEETS.set( href, promise );
+	return promise;
+}

package/themes/umberto/src/gloria/js/helpers/is-element-attached.js ADDED Viewed

@@ -0,0 +1,28 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Asynchronously checks if the given element or any of its parents are detached from the document body.
+ *
+ * @param element The element to check.
+ * @returns A promise that resolves to true if the element or any parent is detached, false otherwise.
+ */
+export async function isElementAttached( element ) {
+	return new Promise( resolve => {
+		// Use requestAnimationFrame to ensure the check happens after any potential DOM manipulations in the same tick.
+		requestAnimationFrame( () => {
+			let currentElement = element;
+			while ( currentElement ) {
+				if ( !document.body.contains( currentElement ) ) {
+					resolve( true ); // Detached
+					return;
+				}
+				currentElement = currentElement.parentElement;
+			}
+			resolve( false ); // Attached
+		} );
+	} );
+}

package/themes/umberto/src/gloria/js/helpers/is-focusable.js ADDED Viewed

@@ -0,0 +1,14 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Checks if an element is focusable (has a valid focus method).
+ *
+ * @param element - Element to check
+ * @returns True if the element is focusable
+ */
+export function isFocusable( element ) {
+	return element?.focus && typeof element.focus === 'function';
+}

package/themes/umberto/src/gloria/js/helpers/is-hidden-element.js ADDED Viewed

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export function isHiddenElement( element ) {
+	return element.style.display === 'none' || element.offsetHeight === 0;
+}

package/themes/umberto/src/gloria/js/helpers/is-mobile.js ADDED Viewed

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export function isMobile() {
+	return window.innerWidth <= 768;
+}

package/themes/umberto/src/gloria/js/helpers/is-unsafe-key.js ADDED Viewed

@@ -0,0 +1,14 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Checks if a property is considered unsafe.
+ *
+ * @param property - The property to check.
+ * @returns True if the property is unsafe, false otherwise.
+ */
+export function isUnsafeProperty( property ) {
+	return [ '__proto__', 'constructor', 'prototype' ].includes( property );
+}

package/themes/umberto/src/gloria/js/helpers/lerp.js ADDED Viewed

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Performs linear interpolation between start and end values based on progress.
+ *
+ * @param start - Starting value
+ * @param end - Ending value
+ * @param progress - Interpolation progress (0-1)
+ * @returns Interpolated value
+ */
+export function lerp( start, end, progress ) {
+	return start + ( end - start ) * progress;
+}
+/**
+ * Creates a lerp function with fixed start and end values.
+ *
+ * @param start - Starting value
+ * @param end - Ending value
+ * @returns Function that takes progress (0-1) and returns interpolated value
+ */
+export function createLerp( start, end ) {
+	return progress => lerp( start, end, progress );
+}

package/themes/umberto/src/gloria/js/helpers/local-storage-helper.js ADDED Viewed

@@ -0,0 +1,133 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Checks if a stored item has expired.
+ * Returns true if the item has an expiration timestamp and it's in the past.
+ */
+const isExpired = parsedValue => {
+	if ( parsedValue && typeof parsedValue === 'object' && parsedValue.__expires ) {
+		const now = Date.now();
+		return parsedValue.__expires < now;
+	}
+	return false;
+};
+/**
+ * Wraps a value with expiration metadata.
+ */
+const wrapWithExpiration = ( value, expire ) => {
+	if ( expire === null ) {
+		return value;
+	}
+	const expirationTime = expire instanceof Date ?
+		expire.getTime() :
+		Date.now() + expire;
+	return {
+		__data: value,
+		__expires: expirationTime
+	};
+};
+/**
+ * Unwraps a value from its expiration container.
+ */
+const unwrapFromExpiration = parsedValue => {
+	if ( parsedValue && typeof parsedValue === 'object' && parsedValue.__expires ) {
+		return parsedValue.__data;
+	}
+	return parsedValue;
+};
+/**
+ * Storage helper for safely interacting with localStorage with automatic JSON parsing.
+ * Handles potential exceptions when localStorage is disabled or unavailable.
+ */
+export const localStorageHelper = {
+	/**
+	 * Safely retrieves and parses an item from localStorage.
+	 * Checks for expiration and removes expired items.
+	 *
+	 * @param key - The key to retrieve
+	 * @param options - Additional options
+	 */
+	get( key, { parseJson = true } = {} ) {
+		try {
+			const value = localStorage.getItem( key );
+			if ( value === null ) {
+				return null;
+			}
+			if ( !parseJson ) {
+				return value;
+			}
+			try {
+				const parsedValue = JSON.parse( value );
+				// Check if item has expired
+				if ( isExpired( parsedValue ) ) {
+					localStorage.removeItem( key );
+					return null;
+				}
+				// Return the actual data without the expiration wrapper
+				return unwrapFromExpiration( parsedValue );
+			} catch ( parseError ) {
+				console.warn( 'Error parsing JSON from localStorage:', parseError );
+				// Not valid JSON, return as string
+				return value;
+			}
+		} catch ( error ) {
+			console.warn( 'Error accessing localStorage:', error );
+			return null;
+		}
+	},
+	/**
+	 * Safely sets an item in localStorage, with automatic JSON stringification.
+	 * Optionally sets an expiration time.
+	 *
+	 * @param key - The key to set
+	 * @param value - The value to store (will be stringified if not a string)
+	 * @param options - Additional options
+	 */
+	set( key, value, { expire = null } = {} ) {
+		try {
+			const dataToStore = wrapWithExpiration( value, expire );
+			const stringValue = typeof dataToStore === 'string' ?
+				dataToStore :
+				JSON.stringify( dataToStore );
+			localStorage.setItem( key, stringValue );
+			return true;
+		} catch ( error ) {
+			console.warn( 'Error writing to localStorage:', error );
+			return false;
+		}
+	},
+	/**
+	 * Safely removes an item from localStorage.
+	 *
+	 * @param key - The key to remove
+	 */
+	remove( key ) {
+		try {
+			localStorage.removeItem( key );
+			return true;
+		} catch ( error ) {
+			console.warn( 'Error removing from localStorage:', error );
+			return false;
+		}
+	}
+};

package/themes/umberto/src/gloria/js/helpers/pipe.js ADDED Viewed

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export function pipe( ...fns ) {
+	return value => fns.reduce( ( acc, fn ) => fn( acc ), value );
+}

package/themes/umberto/src/gloria/js/helpers/prefers-reduced-motion.js ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Checks if the user prefers reduced motion.
+ *
+ * @returns True if the user prefers reduced motion, false otherwise.
+ */
+export function prefersReducedMotion() {
+	return window.matchMedia( '(prefers-reduced-motion: reduce)' ).matches;
+}

package/themes/umberto/src/gloria/js/helpers/random-id.js ADDED Viewed

@@ -0,0 +1,51 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export function randomId( prefix ) {
+	const uuid = uid();
+	return prefix ? `${ prefix }-${ uuid }` : uuid;
+}
+/**
+ * A hash table of hex numbers to avoid using toString() in uid() which is costly.
+ * [ '00', '01', '02', ..., 'fe', 'ff' ]
+ */
+const HEX_NUMBERS = new Array( 256 ).fill( '' )
+	.map( ( _, index ) => ( '0' + ( index ).toString( 16 ) ).slice( -2 ) );
+/**
+ * Returns a unique id. The id starts with an "e" character and a randomly generated string of
+ * 32 alphanumeric characters.
+ *
+ * **Note**: The characters the unique id is built from correspond to the hex number notation
+ * (from "0" to "9", from "a" to "f"). In other words, each id corresponds to an "e" followed
+ * by 16 8-bit numbers next to each other.
+ *
+ * @returns An unique id string.
+ */
+function uid() {
+	// Let's create some positive random 32bit integers first.
+	const [ r1, r2, r3, r4 ] = crypto.getRandomValues( new Uint32Array( 4 ) );
+	// Make sure that id does not start with number.
+	return 'e' +
+		HEX_NUMBERS[ r1 >> 0 & 0xFF ] +
+		HEX_NUMBERS[ r1 >> 8 & 0xFF ] +
+		HEX_NUMBERS[ r1 >> 16 & 0xFF ] +
+		HEX_NUMBERS[ r1 >> 24 & 0xFF ] +
+		HEX_NUMBERS[ r2 >> 0 & 0xFF ] +
+		HEX_NUMBERS[ r2 >> 8 & 0xFF ] +
+		HEX_NUMBERS[ r2 >> 16 & 0xFF ] +
+		HEX_NUMBERS[ r2 >> 24 & 0xFF ] +
+		HEX_NUMBERS[ r3 >> 0 & 0xFF ] +
+		HEX_NUMBERS[ r3 >> 8 & 0xFF ] +
+		HEX_NUMBERS[ r3 >> 16 & 0xFF ] +
+		HEX_NUMBERS[ r3 >> 24 & 0xFF ] +
+		HEX_NUMBERS[ r4 >> 0 & 0xFF ] +
+		HEX_NUMBERS[ r4 >> 8 & 0xFF ] +
+		HEX_NUMBERS[ r4 >> 16 & 0xFF ] +
+		HEX_NUMBERS[ r4 >> 24 & 0xFF ];
+}

package/themes/umberto/src/gloria/js/helpers/sanitize-text.js ADDED Viewed

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Sanitizes text to prevent XSS attacks by removing potentially dangerous characters.
+ *
+ * @param text - The text to sanitize
+ * @returns Sanitized text safe for DOM operations
+ */
+export function sanitizeText( text ) {
+	if ( typeof text !== 'string' ) {
+		return '';
+	}
+	// Create a temporary element to escape HTML entities
+	const temp = document.createElement( 'div' );
+	temp.textContent = text;
+	// Get the escaped text and remove any remaining script tags or event handlers
+	return temp.innerHTML
+		.replace( /<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '' )
+		.replace( /on\w+\s*=\s*"[^"]*"/gi, '' )
+		.replace( /on\w+\s*=\s*'[^']*'/gi, '' )
+		.replace( /javascript:/gi, '' );
+}

package/themes/umberto/src/gloria/js/helpers/scroll-to-hash.js ADDED Viewed

@@ -0,0 +1,31 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import { prefersReducedMotion } from './prefers-reduced-motion';
+export function scrollToHash( target, { margin = 32, pushState = true } = {} ) {
+	const targetId = (
+		typeof target === 'string' ?
+			target :
+			target.getAttribute( 'href' ).substring( 1 )
+	);
+	const targetElement = document.getElementById( targetId );
+	if ( !targetElement ) {
+		return;
+	}
+	const header = document.querySelector( '.js-header' );
+	if ( pushState ) {
+		history.pushState( true, '', target.getAttribute( 'href' ) );
+	}
+	window.scrollTo( {
+		top: targetElement.getBoundingClientRect().top + window.scrollY - header.clientHeight - margin,
+		behavior: prefersReducedMotion() ? 'instant' : 'smooth'
+	} );
+}

package/themes/umberto/src/gloria/js/helpers/take-last.js ADDED Viewed

@@ -0,0 +1,19 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Takes the last N items from an array.
+ *
+ * @param count - Number of items to take from the end.
+ * @param array - The array to take items from.
+ * @returns A new array with the last N items.
+ */
+export function takeLast( count, array ) {
+	if ( count <= 0 || !Array.isArray( array ) ) {
+		return [];
+	}
+	return array.slice( -count );
+}

package/themes/umberto/src/gloria/js/helpers/tap.js ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export function tap( fn ) {
+	return value => {
+		fn( value );
+		return value;
+	};
+}