super-powers/src/ce8cf834-6bac-44fb-941c-861f7e046cc0/code.php

<?php
/**
 * @package    Joomla.Component.Builder
 *
 * @created    3rd September, 2020
 * @author     Llewellyn van der Merwe <https://dev.vdm.io>
 * @git        Joomla Component Builder <https://git.vdm.dev/joomla/Component-Builder>
 * @copyright  Copyright (C) 2015 Vast Development Method. All rights reserved.
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace VDM\Joomla\Utilities\String;


use VDM\Joomla\Utilities\StringHelper;


/**
 * Control the naming of a namespace helper
 * 
 * @since  3.0.9
 */
abstract class NamespaceHelper
{
	/**
	 * Making namespace safe
	 *
	 * @param  string   $string    The namespace string you would like to make safe
	 *
	 * @return string on success
	 * @since  3.0.9
	 */
	public static function safe(string $string): string
	{
		// Remove leading and trailing backslashes
		$string = trim($string, '\\');

		// Split the string into namespace segments
		$segments = explode('\\', $string);

		foreach ($segments as &$segment)
		{
			// Check if segment starts with a number
			if (preg_match("/^\d/", $segment))
			{
				// Extract the starting number(s)
				preg_match("/^\d+/", $segment, $matches);

				if (isset($matches[0]))
				{
					$numberWord = StringHelper::numbers($matches[0]);
					$segment = str_replace($matches[0], $numberWord, $segment);
				}
			}

			// Transliterate string TODO: look again as this makes it lowercase
			// $segment = StringHelper::transliterate($segment);

			// Make sure segment only contains valid characters
			$segment = preg_replace("/[^A-Za-z0-9]/", '', $segment);
		}

		// Join the namespace segments back together
		return implode('\\', $segments);
	}
}