Reorders items by handling '^' (move to front) and '$' (move to end) prefixes.

Creates a dynamic class and optionally extends a parent class.

Get current directory & file. An attempt to brings back the old __dirname and __filename to the ES6 era.

Returns object with the following keys:

• __dirname (aliases to dir) - current directory name
• __filename (aliases to file) - current file path

Example:

const { importModule } = this.app.bajo
const currentLoc = await importModule('bajo:/lib/current-loc.js')

const { __dirname, __filename } = currentLoc(import.meta)
console.log(__dirname, __filename)

Deep-merges objects while replacing arrays from higher-priority inputs.

Waits for a duration and resolves a promise.

Extracts text between two boundary patterns.

Fill object with keys. defValue is used if the corresponding key doesn't have value

Filter array of duplicates

Filter array's indexes

Format text according using sprintf with extra ability to run its arguments through a serie of modifiers Modifier must be place right after a token prepended with pipe ``|``` symbols. You can put as many mofifiers as you want.

E.g:

const text = 'Collected %s|toLower|upperFirst: %d'
const result = this.app.lib.formatText(text, 'iTeMs', 10)
console.log(result) // Collected Items: 10

Returns the caller file path from the current stack trace.

Returns indexes of items that match a predicate.

Finds an object key by value.

Checks whether at least one matcher value exists in an array.

Checks whether a value appears to be a class constructor.

Checks whether a value is neither null nor undefined.

Merges objects by a shared key, where later objects override earlier fields.

Paginates and optionally sorts a collection.

Parse program arguments (args) & options (argv)

Parse duration to its millisecond value. Use ms under the hood

Parse environment variables

Parses key-value text into an object and normalizes primitive types.

Parses an object (or JSON string) and recursively normalizes nested values.

When options.parseValue is enabled, string values are converted using dotenv-parse-variables rules (for example booleans, numbers, arrays, and null), including values inside arrays and nested objects.

Special key handling:

• Keys ending with Dur are converted to milliseconds using parseDuration.
• Keys ending with Dt are converted to Unix timestamps using Date.parse.
• options.translator can translate prefixed keys/values before normalization.

Converts text into PascalCase.

Generate random value.

Resolve file name to filesystem's path. Windows path separator \ is normalized to Unix's /

Rounds a number using decimal precision.

Schedules execution on the next immediate cycle and resolves when it runs.

Attaches missing String polyfills when they are not available in the current runtime. Adds String.prototype.replaceAll and String.prototype.splice if needed.

Converts multiline text into a cleaned array and removes comments.

Converts text to title case with optional ignore and replacement rules.

Returns an array without provided values and empty-like entries.