Utility object that provides several methods to build simple and complex DOM objects

List of valid verbosity levels

Options of the logging system

Labels printed on logs for each message type

Miscellaneous utility functions and constants

Exports third-party NPM packages used by JClic, so they become available to other scripts through
the global variable JClicObject (defined in module:JClic.JClic)

Global constants

Current dictionary of string translations

Appends a stylesheet element to the head or root node nearest to the given HTMLElement.

Traverses all the attributes defined in an Element, calling a function with its name and value as a parameters

Builds a new object based on the provided constructor, data and initialization value
Objects used with this function should implement setAttributes, or an static method named factory

Converts java-like color codes (like '0xRRGGBB') to valid CSS values like '#RRGGBB' or 'rgba(r,g,b,a)'

Checks if the language preferred by the user (based on browser and/or specific settings)
is in a list of available languages.

Extracts just the ISO-639 language code from complex
expressions like "English (en)", buid by JClic Author.

Clones the provided object
See: https://stackoverflow.com/questions/41474986/how-to-clone-a-javascript-es6-class-instance

Checks if the provided color has an alpha value less than 1

Compares the provided answer against multiple valid options. These valid options are
concatenated in a string, separated by pipe chars (|). The comparing can be case sensitive.

Creates a string suitable to be used in the 'style' attribute of HTML tags, filled with the
CSS attributes contained in the provided object.

Checks if the given string ends with the specified expression

Returns a string with the given tag repeated n times

Recursive traversal of all nodes of the given object looking for children having the childName attribute
WARNING: Don't call this method on objects with circular dependencies!

Set the maximum number of decimals for a number

Returns an partial clone of an object, containing only the own attributes specified in an array of possible keys.
When the value of an attribute is of type 'Object' and this object has a method named getAttributes, the result of calling
this method is returned instead of the crude object.

Gets the base path of the given file path (absolute or full URL). This base path always ends
with /, meaning it can be concatenated with relative paths without adding a separator.

Gets a boolean value from a textual expression

Gets the caret position within the given element. Thanks to
Tim Down answers in:
http://stackoverflow.com/questions/4811822/get-a-ranges-start-and-end-offsets-relative-to-its-parent-container
and http://stackoverflow.com/questions/6240139/highlight-text-range-using-javascript/6242538

Returns a formatted string with the provided date and time

Returns a given time in [00h 00'00"] format

Gets a clip of the give image data, in a URL base64 encoded format

Function that will return the translation of the provided key
into the current language.

Gets a number from a string or another number

Gets the complete path of a relative or absolute URL, using the provided basePath

Gets a promise with the complete path of a relative or absolute URL, using the provided basePath

Gets the plain percent expression (without decimals) of the given value

Gets the full path of file relative to basePath

Finds the nearest head or root node of a given HTMLElement, useful to place <style/> elements when
the main component of JClic is behind a shadow-root.
This method will be replaced by a call to Node.getRootNode()
when fully supported by all major browsers.

Replaces width, height and fill attributes of a simple SVG image
with the provided values

Utility function called by module:Utils.getCaretCharacterOffsetWithin

Gets a numeric value (0, 1 or 2) from a set of possible values: false, true and default.

Gets a value from an given expression that can be null, undefined or empty string ('')

Gets the minimal representation of the given value (object, array, string, number...)

Parse the given XML node, known as containing only text elements,
and return its content as a string (when possible)

Reads paragraphs, identified by <p></p> elements, inside XML data

Initializes the global settings

Checks if the given value is an empty object, null or a zero-length string

Checks if two expressions are equivalent.
Returns true when both parameters are null or undefined, and also when both have
equivalent values.

Checks if the provided value is 'null' or 'undefined'.

Check if the given char is a separator

Checks if the given expression is an absolute URL

Check if the given char is a word delimiter

Reports a new message to the logging system

Performs multiple replacements on the provided string
See: https://stackoverflow.com/questions/2501435/replacing-multiple-patterns-in-a-block-of-data

Replaces all occurrences of the backslash character (\) by a regular slash (/)
This is useful to normalize bad path names present in some old JClic projects

Converts expressions of type 'pt-br', 'FR', 'ca_es@valencia'... to the format expected by the i18n system:
lc[_CC][@variant] where 'lc' is a two or three lowercase letter language code, CC is an optional two uppercase
letter country code, followed by an optional 'variant' consisting in letters and/or digits.

Converts string values to number or boolean when needed

Parse 'date' fields generated by "JClic Author" in format d/m/y, with
variable number of digits.

Parse the provided XML element node, returning a complex object

Recursively explore the given object, converting to a string
all attributes with a single attribute named 'text'.
Example:
{a:1, b:{text:"hello"}, c:{d:2, text:"world"}} => {a:1, b:"hello", c:{d:2, text:"world"}}

Rounds v to the nearest multiple of n

Fills an object with specific attributes from another data object

Establishes the current verbosity level of the logging system

Sets the selection range (or the cursor position, when start and end are the same) to a
specific position inside a DOM element.

Checks if the given string starts with the specified expression

Converts a string in an array of objects with 'text' and 'sep' attributes, where 'text' are single words and 'sep'
are the word separators following each word in the sentence.

Encodes a svg expression into a data URI
suitable for the src property of img elements, optionally changing its original size and fill values.

Converts the given expression into a valid value for CSS size values

Returns the two-digits text expression representing the given number (lesser than 100) zero-padded at left
Useful for representing hours, minutes and seconds