tiny-essentials 1.24.0 → 1.24.1

package/dist/legacy/get/queryUrlByName.cjs

@@ -1,32 +0,0 @@
-'use strict';
-
-/**
- * Extracts the value of a specific query parameter from a URL.
- *
- * - Supports parameter names with brackets (e.g. `arr[0]`).
- * - Returns `null` if the parameter is not found.
- * - Returns an empty string if the parameter exists without a value.
- *
- * Examples:
- * ```js
- * queryUrlByName('foo', 'http://example.com/?foo=bar'); // "bar"
- * queryUrlByName('foo', 'http://example.com/?foo=');    // ""
- * queryUrlByName('foo', 'http://example.com/');         // null
- * queryUrlByName('arr[0]', 'http://x.com/?arr[0]=yes'); // "yes"
- * ```
- *
- * @param {string} name - The name of the query parameter to retrieve.
- * @param {string} url - The full URL from which to extract the parameter.
- * @returns {string|null} The decoded value of the parameter, or `null` if not found.
- * @deprecated
- */
-function queryUrlByName(name, url) {
-  let newName = name.replace(/[\[\]]/g, '\\$&');
-  var regex = new RegExp('[?&]' + newName + '(=([^&#]*)|&|#|$)'),
-    results = regex.exec(url);
-  if (!results) return null;
-  if (!results[2]) return '';
-  return decodeURIComponent(results[2].replace(/\+/g, ' '));
-}
-
-module.exports = queryUrlByName;

package/dist/legacy/get/queryUrlByName.d.mts

@@ -1,22 +0,0 @@
-/**
- * Extracts the value of a specific query parameter from a URL.
- *
- * - Supports parameter names with brackets (e.g. `arr[0]`).
- * - Returns `null` if the parameter is not found.
- * - Returns an empty string if the parameter exists without a value.
- *
- * Examples:
- * ```js
- * queryUrlByName('foo', 'http://example.com/?foo=bar'); // "bar"
- * queryUrlByName('foo', 'http://example.com/?foo=');    // ""
- * queryUrlByName('foo', 'http://example.com/');         // null
- * queryUrlByName('arr[0]', 'http://x.com/?arr[0]=yes'); // "yes"
- * ```
- *
- * @param {string} name - The name of the query parameter to retrieve.
- * @param {string} url - The full URL from which to extract the parameter.
- * @returns {string|null} The decoded value of the parameter, or `null` if not found.
- * @deprecated
- */
-export default function queryUrlByName(name: string, url: string): string | null;
-//# sourceMappingURL=queryUrlByName.d.mts.map

package/dist/legacy/get/queryUrlByName.mjs

@@ -1,29 +0,0 @@
-/**
- * Extracts the value of a specific query parameter from a URL.
- *
- * - Supports parameter names with brackets (e.g. `arr[0]`).
- * - Returns `null` if the parameter is not found.
- * - Returns an empty string if the parameter exists without a value.
- *
- * Examples:
- * ```js
- * queryUrlByName('foo', 'http://example.com/?foo=bar'); // "bar"
- * queryUrlByName('foo', 'http://example.com/?foo=');    // ""
- * queryUrlByName('foo', 'http://example.com/');         // null
- * queryUrlByName('arr[0]', 'http://x.com/?arr[0]=yes'); // "yes"
- * ```
- *
- * @param {string} name - The name of the query parameter to retrieve.
- * @param {string} url - The full URL from which to extract the parameter.
- * @returns {string|null} The decoded value of the parameter, or `null` if not found.
- * @deprecated
- */
-export default function queryUrlByName(name, url) {
-    let newName = name.replace(/[\[\]]/g, '\\$&');
-    var regex = new RegExp('[?&]' + newName + '(=([^&#]*)|&|#|$)'), results = regex.exec(url);
-    if (!results)
-        return null;
-    if (!results[2])
-        return '';
-    return decodeURIComponent(results[2].replace(/\+/g, ' '));
-}

package/dist/legacy/get/queryUrlJSON.cjs

@@ -1,57 +0,0 @@
-'use strict';
-
-/**
- * Parses the query string from a URL into a JSON object.
- *
- * - Supports `key=value` pairs.
- * - Supports array syntax (`arr[]=1&arr[]=2`, or `arr[1]=x`).
- * - Ignores fragments (`#`).
- * - If no URL is passed, uses `window.location.href` by default.
- *
- * Examples:
- * ```js
- * queryUrlJSON('http://example.com/?name=John&colors[]=red&colors[]=blue');
- * // => { name: 'John', colors: ['red', 'blue'] }
- *
- * queryUrlJSON('http://x.com/?arr[1]=a&arr[0]=b');
- * // => { arr: ['b', 'a'] }
- * ```
- *
- * @param {string} [url=location.href] - The full URL to parse.
- * @returns {Object.<string, string|string[]>} A key-value object representing the parsed query.
- * @deprecated
- */
-function queryUrlJSON(url) {
-  if (!url) url = location.href;
-  var question = url.indexOf('?');
-  var hash = url.indexOf('#');
-  if (hash === -1 && question === -1) return {};
-  if (hash === -1) hash = url.length;
-  var query =
-    question === -1 || hash === question + 1
-      ? url.substring(hash)
-      : url.substring(question + 1, hash);
-
-  /** @type {Record<string, *>} */
-  var result = {};
-  query.split('&').forEach((part) => {
-    if (!part) return;
-    part = part.split('+').join(' '); // replace every + with space, regexp-free version
-    var eq = part.indexOf('=');
-    var key = eq > -1 ? part.substr(0, eq) : part;
-    var val = eq > -1 ? decodeURIComponent(part.substr(eq + 1)) : '';
-    var from = key.indexOf('[');
-    if (from === -1) result[decodeURIComponent(key)] = val;
-    else {
-      var to = key.indexOf(']', from);
-      var index = decodeURIComponent(key.substring(from + 1, to));
-      key = decodeURIComponent(key.substring(0, from));
-      if (!result[key]) result[key] = [];
-      if (!index) result[key].push(val);
-      else result[key][index] = val;
-    }
-  });
-  return result;
-}
-
-module.exports = queryUrlJSON;

package/dist/legacy/get/queryUrlJSON.d.mts

@@ -1,25 +0,0 @@
-/**
- * Parses the query string from a URL into a JSON object.
- *
- * - Supports `key=value` pairs.
- * - Supports array syntax (`arr[]=1&arr[]=2`, or `arr[1]=x`).
- * - Ignores fragments (`#`).
- * - If no URL is passed, uses `window.location.href` by default.
- *
- * Examples:
- * ```js
- * queryUrlJSON('http://example.com/?name=John&colors[]=red&colors[]=blue');
- * // => { name: 'John', colors: ['red', 'blue'] }
- *
- * queryUrlJSON('http://x.com/?arr[1]=a&arr[0]=b');
- * // => { arr: ['b', 'a'] }
- * ```
- *
- * @param {string} [url=location.href] - The full URL to parse.
- * @returns {Object.<string, string|string[]>} A key-value object representing the parsed query.
- * @deprecated
- */
-export default function queryUrlJSON(url?: string): {
-    [x: string]: string | string[];
-};
-//# sourceMappingURL=queryUrlJSON.d.mts.map

package/dist/legacy/get/queryUrlJSON.mjs

@@ -1,59 +0,0 @@
-/**
- * Parses the query string from a URL into a JSON object.
- *
- * - Supports `key=value` pairs.
- * - Supports array syntax (`arr[]=1&arr[]=2`, or `arr[1]=x`).
- * - Ignores fragments (`#`).
- * - If no URL is passed, uses `window.location.href` by default.
- *
- * Examples:
- * ```js
- * queryUrlJSON('http://example.com/?name=John&colors[]=red&colors[]=blue');
- * // => { name: 'John', colors: ['red', 'blue'] }
- *
- * queryUrlJSON('http://x.com/?arr[1]=a&arr[0]=b');
- * // => { arr: ['b', 'a'] }
- * ```
- *
- * @param {string} [url=location.href] - The full URL to parse.
- * @returns {Object.<string, string|string[]>} A key-value object representing the parsed query.
- * @deprecated
- */
-export default function queryUrlJSON(url) {
-    if (!url)
-        url = location.href;
-    var question = url.indexOf('?');
-    var hash = url.indexOf('#');
-    if (hash === -1 && question === -1)
-        return {};
-    if (hash === -1)
-        hash = url.length;
-    var query = question === -1 || hash === question + 1
-        ? url.substring(hash)
-        : url.substring(question + 1, hash);
-    /** @type {Record<string, *>} */
-    var result = {};
-    query.split('&').forEach((part) => {
-        if (!part)
-            return;
-        part = part.split('+').join(' '); // replace every + with space, regexp-free version
-        var eq = part.indexOf('=');
-        var key = eq > -1 ? part.substr(0, eq) : part;
-        var val = eq > -1 ? decodeURIComponent(part.substr(eq + 1)) : '';
-        var from = key.indexOf('[');
-        if (from === -1)
-            result[decodeURIComponent(key)] = val;
-        else {
-            var to = key.indexOf(']', from);
-            var index = decodeURIComponent(key.substring(from + 1, to));
-            key = decodeURIComponent(key.substring(0, from));
-            if (!result[key])
-                result[key] = [];
-            if (!index)
-                result[key].push(val);
-            else
-                result[key][index] = val;
-        }
-    });
-    return result;
-}

package/dist/legacy/get/super_string_filter.cjs

@@ -1,109 +0,0 @@
-'use strict';
-
-var objFilter = require('../../v1/basics/objFilter.cjs');
-
-/**
- * Filters a list of strings by comparing each item against a list of validators.
- *
- * Each validator can be either:
- * - A **string** (for exact match)
- * - An **object** with one or more of the following:
- *   - `starts`: {string} - The string must start with this prefix.
- *   - `ends`: {string} - The string must end with this suffix.
- *   - `regexp`: {RegExp} - The string must match the regular expression.
- *
- * The comparison stops at the first matching validator per item.
- *
- * Examples:
- * ```js
- * super_string_filter(['apple', 'banana', 'blueberry'], ['banana']); // ['banana']
- * super_string_filter(['apple', 'banana'], [{ starts: 'app' }]); // ['apple']
- * super_string_filter(['test.js'], [{ ends: '.js' }]); // ['test.js']
- * super_string_filter(['data123'], [{ regexp: /^\w+\d+$/ }]); // ['data123']
- * ```
- *
- * @param {string[]} list - The list of strings to filter.
- * @param {(string|Object)[]} validator_list - The list of validators.
- * @returns {string[]} A filtered array of strings that passed at least one validator.
- * @deprecated
- */
-function super_string_filter(list, validator_list) {
-  // Result
-  const result = [];
-
-  // The For
-  for (const item in list) {
-    for (const item2 in validator_list) {
-      // Check Types
-
-      // String
-      if (typeof validator_list[item2] === 'string') {
-        if (list[item] === validator_list[item2]) {
-          result.push(validator_list[item2]);
-          break;
-        }
-      }
-
-      // Object
-      else if (objFilter.objType(validator_list[item2], 'object')) {
-        // Validator
-        const tiny_validator = {};
-
-        // Starts With
-        tiny_validator.starts = {};
-        // @ts-ignore
-        tiny_validator.starts.enabled = typeof validator_list[item2].starts === 'string';
-        // @ts-ignore
-        if (tiny_validator.starts.enabled) {
-          // @ts-ignore
-          tiny_validator.starts.result = list[item].startsWith(validator_list[item2].starts);
-        }
-
-        // Ends With
-        tiny_validator.ends = {};
-        // @ts-ignore
-        tiny_validator.ends.enabled = typeof validator_list[item2].ends === 'string';
-        // @ts-ignore
-        if (tiny_validator.ends.enabled) {
-          // @ts-ignore
-          tiny_validator.ends.result = list[item].endsWith(validator_list[item2].ends);
-        }
-
-        // RegExp
-        tiny_validator.regexp = {};
-        // @ts-ignore
-        tiny_validator.regexp.enabled = objFilter.objType(validator_list[item2].regexp, 'regexp');
-        // @ts-ignore
-        if (tiny_validator.regexp.enabled) {
-          // @ts-ignore
-          tiny_validator.regexp.result = list[item].match(validator_list[item2].regexp);
-        }
-
-        // Check Validator
-        let allowed_timezone = true;
-        for (const item3 in tiny_validator) {
-          // @ts-ignore
-          if (tiny_validator[item3].enabled) {
-            // Invalid Result
-            // @ts-ignore
-            if (!tiny_validator[item3].result) {
-              allowed_timezone = false;
-              break;
-            }
-          }
-        }
-
-        // Start With
-        if (allowed_timezone) {
-          result.push(list[item]);
-          break;
-        }
-      }
-    }
-  }
-
-  // Result
-  return result;
-}
-
-module.exports = super_string_filter;

package/dist/legacy/get/super_string_filter.d.mts

@@ -1,27 +0,0 @@
-/**
- * Filters a list of strings by comparing each item against a list of validators.
- *
- * Each validator can be either:
- * - A **string** (for exact match)
- * - An **object** with one or more of the following:
- *   - `starts`: {string} - The string must start with this prefix.
- *   - `ends`: {string} - The string must end with this suffix.
- *   - `regexp`: {RegExp} - The string must match the regular expression.
- *
- * The comparison stops at the first matching validator per item.
- *
- * Examples:
- * ```js
- * super_string_filter(['apple', 'banana', 'blueberry'], ['banana']); // ['banana']
- * super_string_filter(['apple', 'banana'], [{ starts: 'app' }]); // ['apple']
- * super_string_filter(['test.js'], [{ ends: '.js' }]); // ['test.js']
- * super_string_filter(['data123'], [{ regexp: /^\w+\d+$/ }]); // ['data123']
- * ```
- *
- * @param {string[]} list - The list of strings to filter.
- * @param {(string|Object)[]} validator_list - The list of validators.
- * @returns {string[]} A filtered array of strings that passed at least one validator.
- * @deprecated
- */
-export default function super_string_filter(list: string[], validator_list: (string | Object)[]): string[];
-//# sourceMappingURL=super_string_filter.d.mts.map

package/dist/legacy/get/super_string_filter.mjs

@@ -1,95 +0,0 @@
-import objType from './objType.mjs';
-/**
- * Filters a list of strings by comparing each item against a list of validators.
- *
- * Each validator can be either:
- * - A **string** (for exact match)
- * - An **object** with one or more of the following:
- *   - `starts`: {string} - The string must start with this prefix.
- *   - `ends`: {string} - The string must end with this suffix.
- *   - `regexp`: {RegExp} - The string must match the regular expression.
- *
- * The comparison stops at the first matching validator per item.
- *
- * Examples:
- * ```js
- * super_string_filter(['apple', 'banana', 'blueberry'], ['banana']); // ['banana']
- * super_string_filter(['apple', 'banana'], [{ starts: 'app' }]); // ['apple']
- * super_string_filter(['test.js'], [{ ends: '.js' }]); // ['test.js']
- * super_string_filter(['data123'], [{ regexp: /^\w+\d+$/ }]); // ['data123']
- * ```
- *
- * @param {string[]} list - The list of strings to filter.
- * @param {(string|Object)[]} validator_list - The list of validators.
- * @returns {string[]} A filtered array of strings that passed at least one validator.
- * @deprecated
- */
-export default function super_string_filter(list, validator_list) {
-    // Result
-    const result = [];
-    // The For
-    for (const item in list) {
-        for (const item2 in validator_list) {
-            // Check Types
-            // String
-            if (typeof validator_list[item2] === 'string') {
-                if (list[item] === validator_list[item2]) {
-                    result.push(validator_list[item2]);
-                    break;
-                }
-            }
-            // Object
-            else if (objType(validator_list[item2], 'object')) {
-                // Validator
-                const tiny_validator = {};
-                // Starts With
-                tiny_validator.starts = {};
-                // @ts-ignore
-                tiny_validator.starts.enabled = typeof validator_list[item2].starts === 'string';
-                // @ts-ignore
-                if (tiny_validator.starts.enabled) {
-                    // @ts-ignore
-                    tiny_validator.starts.result = list[item].startsWith(validator_list[item2].starts);
-                }
-                // Ends With
-                tiny_validator.ends = {};
-                // @ts-ignore
-                tiny_validator.ends.enabled = typeof validator_list[item2].ends === 'string';
-                // @ts-ignore
-                if (tiny_validator.ends.enabled) {
-                    // @ts-ignore
-                    tiny_validator.ends.result = list[item].endsWith(validator_list[item2].ends);
-                }
-                // RegExp
-                tiny_validator.regexp = {};
-                // @ts-ignore
-                tiny_validator.regexp.enabled = objType(validator_list[item2].regexp, 'regexp');
-                // @ts-ignore
-                if (tiny_validator.regexp.enabled) {
-                    // @ts-ignore
-                    tiny_validator.regexp.result = list[item].match(validator_list[item2].regexp);
-                }
-                // Check Validator
-                let allowed_timezone = true;
-                for (const item3 in tiny_validator) {
-                    // @ts-ignore
-                    if (tiny_validator[item3].enabled) {
-                        // Invalid Result
-                        // @ts-ignore
-                        if (!tiny_validator[item3].result) {
-                            allowed_timezone = false;
-                            break;
-                        }
-                    }
-                }
-                // Start With
-                if (allowed_timezone) {
-                    result.push(list[item]);
-                    break;
-                }
-            }
-        }
-    }
-    // Result
-    return result;
-}

package/dist/legacy/get/versionCheck.cjs

@@ -1,50 +0,0 @@
-'use strict';
-
-var latestVersion = require('latest-version');
-var compareVersions = require('compare-versions');
-var moment = require('moment');
-
-// Modules
-
-/**
- * @typedef {{
- *  needUpdate: boolean; // `true` if the current version is outdated, `false` otherwise.
- *   now: string; // The current version of the package.
- *   new: string; // The latest version of the package available on npm.
- * }} VersionCheck
- */
-
-/**
- * Checks if the package version is up-to-date by comparing it with the latest version available on npm.
- * The version check is cached and updated every hour.
- *
- * @param {Object} pkg - The package information.
- * @param {string} pkg.name - The name of the package.
- * @param {string} pkg.version - The current version of the package.
- *
- * @returns {Promise<VersionCheck>} The result object
- * @deprecated
-
- */
-async function versionCheck(pkg) {
-  /** @type {{ t: import('moment').Moment, v: string }} */
-  const check_version = {};
-
-  // Time Now
-  const now = moment();
-
-  // Check Version
-  if (!check_version.t || now.diff(check_version.t, 'hours') > 0) {
-    check_version.t = now.add(1, 'hours');
-    check_version.v = await latestVersion(pkg.name);
-  }
-
-  // Allowed Show Version
-  return {
-    now: pkg.version,
-    new: check_version.v,
-    needUpdate: compareVersions.compare(pkg.version, check_version.v, '<'),
-  };
-}
-
-module.exports = versionCheck;

package/dist/legacy/get/versionCheck.d.mts

@@ -1,29 +0,0 @@
-/**
- * @typedef {{
- *  needUpdate: boolean; // `true` if the current version is outdated, `false` otherwise.
- *   now: string; // The current version of the package.
- *   new: string; // The latest version of the package available on npm.
- * }} VersionCheck
- */
-/**
- * Checks if the package version is up-to-date by comparing it with the latest version available on npm.
- * The version check is cached and updated every hour.
- *
- * @param {Object} pkg - The package information.
- * @param {string} pkg.name - The name of the package.
- * @param {string} pkg.version - The current version of the package.
- *
- * @returns {Promise<VersionCheck>} The result object
- * @deprecated
-
- */
-export default function versionCheck(pkg: {
-    name: string;
-    version: string;
-}): Promise<VersionCheck>;
-export type VersionCheck = {
-    needUpdate: boolean;
-    now: string;
-    new: string;
-};
-//# sourceMappingURL=versionCheck.d.mts.map

package/dist/legacy/get/versionCheck.mjs

@@ -1,40 +0,0 @@
-// Modules
-import latestVersion from 'latest-version';
-import { compare } from 'compare-versions';
-import moment from 'moment';
-/**
- * @typedef {{
- *  needUpdate: boolean; // `true` if the current version is outdated, `false` otherwise.
- *   now: string; // The current version of the package.
- *   new: string; // The latest version of the package available on npm.
- * }} VersionCheck
- */
-/**
- * Checks if the package version is up-to-date by comparing it with the latest version available on npm.
- * The version check is cached and updated every hour.
- *
- * @param {Object} pkg - The package information.
- * @param {string} pkg.name - The name of the package.
- * @param {string} pkg.version - The current version of the package.
- *
- * @returns {Promise<VersionCheck>} The result object
- * @deprecated
-
- */
-export default async function versionCheck(pkg) {
-    /** @type {{ t: import('moment').Moment, v: string }} */
-    const check_version = {};
-    // Time Now
-    const now = moment();
-    // Check Version
-    if (!check_version.t || now.diff(check_version.t, 'hours') > 0) {
-        check_version.t = now.add(1, 'hours');
-        check_version.v = await latestVersion(pkg.name);
-    }
-    // Allowed Show Version
-    return {
-        now: pkg.version,
-        new: check_version.v,
-        needUpdate: compare(pkg.version, check_version.v, '<'),
-    };
-}