tiny-essentials 1.23.2 → 1.24.1

package/docs/v1/libs/TinyColorValidator.md

@@ -0,0 +1,532 @@
+# 🎨 TinyColorValidator Documentation
+
+## 📐 Angle Units
+
+```ts
+/**
+ * Represents the allowed angle unit types for CSS color functions.
+ *
+ * - `deg` → Degrees (0–360).
+ * - `grad` → Gradians (0–400).
+ * - `rad` → Radians (0–2π).
+ * - `turn` → Turns (0–1).
+ */
+type AngleUnit = 'deg' | 'grad' | 'rad' | 'turn';
+```
+
+---
+
+## 🌈 TinyColorValidator Class
+
+The `TinyColorValidator` class provides utilities for validating and parsing **CSS color values** in multiple formats.
+It supports **hex, RGB/RGBA, HSL/HSLA, HWB, LAB, LCH, HTML named colors, and special keywords**.
+
+### ✨ Features
+
+* Validate (`isHex`, `isRgb`, `isHsl`, etc.) color formats.
+* Parse (`parseRgb`, `parseHsl`, etc.) into numeric components.
+* Manage and extend HTML color names and special keywords dynamically.
+
+### 🧩 Example
+
+```js
+const validator = new TinyColorValidator("rgb(255, 0, 0)");
+
+console.log(validator.isRgb());    // true ✅
+console.log(validator.parseRgb()); // [255, 0, 0]
+```
+
+---
+
+## 🎨 Supported Formats
+
+* **Hexadecimal** → `#RGB`, `#RRGGBB`, `#RRGGBBAA`
+* **RGB / RGBA** → `rgb(r, g, b)`, `rgba(r, g, b, a)`
+* **HSL / HSLA** → `hsl(h, s%, l%)`, `hsla(h, s%, l%, a)`
+* **HWB** → `hwb(hue whiteness% blackness%)`
+* **LAB** → `lab(L a b)`
+* **LCH** → `lch(L C H)`
+* **HTML Named Colors** → e.g. `red`, `blue`, `rebeccapurple`
+* **Special Keywords** → `transparent`, `currentColor`
+
+---
+
+## 🖌️ HTML Color Names API
+
+```ts
+TinyColorValidator.getNames(): string[]
+TinyColorValidator.addName(name: string): boolean
+TinyColorValidator.removeName(name: string): boolean
+TinyColorValidator.hasName(name: string): boolean
+```
+
+* **`getNames()`** → Returns all HTML color names as an array.
+* **`addName(name)`** → Adds a new HTML color name (case-insensitive).
+* **`removeName(name)`** → Removes an existing HTML color name.
+* **`hasName(name)`** → Checks if a given name exists.
+
+---
+
+## 🌟 Special Color Names API
+
+```ts
+TinyColorValidator.getSpecialNames(): string[]
+TinyColorValidator.addSpecialName(name: string): boolean
+TinyColorValidator.removeSpecialName(name: string): boolean
+TinyColorValidator.hasSpecialName(name: string): boolean
+```
+
+* **`getSpecialNames()`** → Returns all special keywords.
+* **`addSpecialName(name)`** → Adds a new special keyword.
+* **`removeSpecialName(name)`** → Removes an existing keyword.
+* **`hasSpecialName(name)`** → Checks if the keyword exists.
+
+---
+
+## 🧱 Instance Properties
+
+```ts
+class TinyColorValidator {
+  #code: string;
+
+  constructor(code: TinyColorValidatorT);
+  get code(): string;
+}
+```
+
+* **`#code`** → Internal storage for the provided color string.
+* **`get code()`** → Retrieves the original input string.
+* **`constructor(code)`** → Creates a new validator instance with the given color string.
+
+### 🏷️ Color Type Storage
+
+* **Private property:** `#type`
+* **Type:** `ColorTypes | null`
+* **Description:** Internal storage for the detected type of the CSS color.
+
+```ts
+/**
+ * Internal storage for the code type.
+ * @type {ColorTypes|null}
+ */
+#type;
+```
+
+* **Getter:** `type`
+* **Returns:** `ColorTypes | null`
+* **Description:** Returns the currently stored color type.
+
+```ts
+/**
+ * Gets the current code type.
+ * @returns {ColorTypes|null} The stored code type.
+ */
+get type() {
+  return this.#type;
+}
+```
+
+---
+
+## 🎨 HEX & HEXA Validation
+
+### 🔍 `static isHex(input: string): boolean`
+
+Validates whether a string is a valid HEX color (`#RGB` or `#RRGGBB`).
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isHex(): boolean`
+
+Instance method that validates the stored color code as a HEX color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `static isHexa(input: string): boolean`
+
+Validates whether a string is a valid HEXA color (`#RRGGBBAA`).
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isHexa(): boolean`
+
+Instance method that validates the stored color code as a HEXA color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+## 🎨 RGB & RGBA Validation
+
+### 🔍 `static isRgb(input: string): boolean`
+
+Validates whether a string is a valid RGB color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isRgb(): boolean`
+
+Instance method that validates the stored color code as an RGB color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+### 🔍 `static isRgba(input: string): boolean`
+
+Validates whether a string is a valid RGBA color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isRgba(): boolean`
+
+Instance method that validates the stored color code as an RGBA color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+## 🎨 HSL & HSLA Validation
+
+### 🔍 `static isHsl(input: string): boolean`
+
+Validates whether a string is a valid HSL color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isHsl(): boolean`
+
+Instance method that validates the stored color code as an HSL color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+### 🔍 `static isHsla(input: string): boolean`
+
+Validates whether a string is a valid HSLA color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isHsla(): boolean`
+
+Instance method that validates the stored color code as an HSLA color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+## 🎨 HWB, Lab & LCH Validation
+
+### 🔍 `static isHwb(input: string): boolean`
+
+Validates whether a string is a valid HWB color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isHwb(): boolean`
+
+Instance method that validates the stored color code as an HWB color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+### 🔍 `static isLab(input: string): boolean`
+
+Validates whether a string is a valid CIELAB (Lab) color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isLab(): boolean`
+
+Instance method that validates the stored color code as a Lab color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+### 🔍 `static isLch(input: string): boolean`
+
+Validates whether a string is a valid LCH color.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isLch(): boolean`
+
+Instance method that validates the stored color code as an LCH color.
+
+* ✅ Returns `true` if valid.
+
+---
+
+## 🎨 Named Colors
+
+### 🔍 `static isName(input: string): boolean`
+
+Validates whether a string matches a **standard HTML color name**.
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isName(): boolean`
+
+Instance method that validates the stored color code as a **standard HTML color name**.
+
+* ✅ Returns `true` if valid.
+
+---
+
+### 🔍 `static isSpecialName(input: string): boolean`
+
+Validates whether a string matches a **special CSS color keyword** (e.g., `currentColor`, `transparent`).
+
+* ✅ Returns `true` if valid.
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+### 🔍 `isSpecialName(): boolean`
+
+Instance method that validates the stored color code as a **special CSS color keyword**.
+
+* ✅ Returns `true` if valid.
+
+---
+
+## 🎨 Universal Color Validation
+
+### 🔍 `static isColor(input: string): string|null`
+
+Checks whether a string is **any valid CSS color**, including:
+
+* HEX / HEXA
+
+* RGB / RGBA
+
+* HSL / HSLA
+
+* HWB
+
+* Lab
+
+* LCH
+
+* HTML color names
+
+* Special CSS keywords
+
+* ✅ Returns `true` if valid.
+
+* ⚠️ Throws `TypeError` if input is not a string.
+
+---
+
+## 🎨 Color Parsing
+
+### 🔍 `parse(): any[] | string | null`
+
+Automatically parses the stored color code based on its detected type (`#type`). 
+
+* 📤 Returns numeric components for functional colors (RGB, HSL, Lab, etc.) or the lowercase string for named/special colors. Returns `null` if the code is invalid.
+
+---
+
+### 🔎 `static parseHex(input: string): string|null`
+
+Parses a HEX color (`#RGB` or `#RRGGBB`).
+
+* 📥 Input: HEX string.
+* 📤 Output: Regex match group or `null` if invalid.
+
+---
+
+### 🔎 `parseHex(): string|null`
+
+Parses the stored color code as a HEX color.
+
+* 📤 Returns match result or `null` if invalid.
+
+---
+
+### 🔎 `static parseHexa(input: string): string|null`
+
+Parses a HEXA color (`#RRGGBBAA`).
+
+* 📥 Input: HEXA string.
+* 📤 Output: Regex match group or `null` if invalid.
+
+---
+
+### 🔎 `parseHexa(): string|null`
+
+Parses the stored color code as a HEXA color.
+
+* 📤 Returns match result or `null` if invalid.
+
+---
+
+## 🎨 Parsing RGB & RGBA
+
+### 🔎 `static parseRgb(input: string): [number, number, number]|null`
+
+Parses an RGB color (`rgb(r, g, b)`).
+
+* 📥 Input: RGB string.
+* 📤 Output: `[r, g, b]` as numbers, or `null` if invalid.
+
+---
+
+### 🔎 `parseRgb(): [number, number, number]|null`
+
+Parses the stored color code as an RGB color.
+
+* 📤 Returns `[r, g, b]` or `null`.
+
+---
+
+### 🔎 `static parseRgba(input: string): [number, number, number, number]|null`
+
+Parses an RGBA color (`rgba(r, g, b, a)`).
+
+* 📥 Input: RGBA string.
+* 📤 Output: `[r, g, b, a]` as numbers, or `null` if invalid.
+
+---
+
+### 🔎 `parseRgba(): [number, number, number, number]|null`
+
+Parses the stored color code as an RGBA color.
+
+* 📤 Returns `[r, g, b, a]` or `null`.
+
+---
+
+## 🎨 Parsing HSL & HSLA
+
+### 🔎 `static parseHsl(input: string): [number, number, number]|null`
+
+Parses an HSL color string (`hsl(h, s%, l%)`).
+
+* 📥 Input: HSL string
+* 📤 Output: `[h, s, l]` as numbers, or `null` if invalid
+* ⚠️ Throws `TypeError` if input is not a string
+
+---
+
+### 🔎 `parseHsl(): [number, number, number]|null`
+
+Parses the stored color code as an HSL color.
+
+* 📤 Returns `[h, s, l]` or `null`
+
+---
+
+### 🔎 `static parseHsla(input: string): [number, number, number, number]|null`
+
+Parses an HSLA color string (`hsla(h, s%, l%, a)`).
+
+* 📥 Input: HSLA string
+* 📤 Output: `[h, s, l, a]` as numbers, or `null` if invalid
+* ⚠️ Throws `TypeError` if input is not a string
+
+---
+
+### 🔎 `parseHsla(): [number, number, number, number]|null`
+
+Parses the stored color code as an HSLA color.
+
+* 📤 Returns `[h, s, l, a]` or `null`
+
+---
+
+## 🎨 Parsing HWB
+
+### 🔎 `static parseHwb(input: string): [number, AngleUnit|null, number, number]|null`
+
+Parses an HWB color string (`hwb(hue, whiteness%, blackness%[, alpha])`).
+
+* 📥 Input: HWB string
+* 📤 Output: `[hue, angleUnit, whiteness, blackness]` or `null`
+* ⚠️ Throws `TypeError` if input is not a string
+
+---
+
+### 🔎 `parseHwb(): [number, AngleUnit|null, number, number]|null`
+
+Parses the stored color code as an HWB color.
+
+* 📤 Returns `[hue, angleUnit, whiteness, blackness]` or `null`
+
+---
+
+## 🎨 Parsing Lab (CIELAB)
+
+### 🔎 `static parseLab(input: string): [number, number, number]|null`
+
+Parses a Lab color string (`lab(L a b[/alpha])`).
+
+* 📥 Input: Lab string
+* 📤 Output: `[L, a, b]` as numbers, or `null` if invalid
+* ⚠️ Throws `TypeError` if input is not a string
+
+---
+
+### 🔎 `parseLab(): [number, number, number]|null`
+
+Parses the stored color code as a Lab color.
+
+* 📤 Returns `[L, a, b]` or `null`
+
+---
+
+## 🎨 Parsing LCH
+
+### 🔎 `static parseLch(input: string): [number, number, number, AngleUnit|null]|null`
+
+Parses an LCH color string (`lch(L C H[/alpha])`).
+
+* 📥 Input: LCH string
+* 📤 Output: `[L, C, H, angleUnit]` or `null`
+* ⚠️ Throws `TypeError` if input is not a string
+
+---
+
+### 🔎 `parseLch(): [number, number, number, AngleUnit|null]|null`
+
+Parses the stored color code as an LCH color.
+
+* 📤 Returns `[L, C, H, angleUnit]` or `null`

package/docs/v1/libs/TinyHtml.md

@@ -1538,10 +1538,10 @@ TinyHtml provides methods to **read** and **set** an element's dimensions, simil
 
 ### 🔍 Reading Dimensions
 
-#### `.width()` / `TinyHtml.width(el)`
+#### `.width` / `TinyHtml.width(el)`
 Returns the **content box width** (excluding padding, border, and margin).
 
-#### `.height()` / `TinyHtml.height(el)`
+#### `.height` / `TinyHtml.height(el)`
 Returns the **content box height**.
 
 ---
@@ -1777,12 +1777,12 @@ element.tagName(); // → "DIV", "SPAN", etc.
 
 ---
 
-### 🆔 `.id()` / `TinyHtml.id(el)`
+### 🆔 `.id` / `TinyHtml.id(el)`
 
 Returns the ID attribute value of the element.
 
 ```js
-element.id(); // → "my-element-id"
+element.id; // → "my-element-id"
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.23.2",
+  "version": "1.24.1",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",
@@ -164,6 +164,10 @@
       "require": "./dist/v1/libs/TinyLoadingScreen.cjs",
       "import": "./dist/v1/libs/TinyLoadingScreen.mjs"
     },
+    "./libs/TinyColorValidator": {
+      "require": "./dist/v1/libs/TinyColorValidator.cjs",
+      "import": "./dist/v1/libs/TinyColorValidator.mjs"
+    },
     "./libs/TinyInventoryTrader": {
       "require": "./dist/v1/libs/TinyInventoryTrader.cjs",
       "import": "./dist/v1/libs/TinyInventoryTrader.mjs"
@@ -184,6 +188,10 @@
       "require": "./dist/v1/libs/TinyHtml.cjs",
       "import": "./dist/v1/libs/TinyHtml.mjs"
     },
+    "./libs/TinyLevelUp": {
+      "require": "./dist/v1/libs/TinyLevelUp.cjs",
+      "import": "./dist/v1/libs/TinyLevelUp.mjs"
+    },
     "./libs/TinyGamepad": {
       "require": "./dist/v1/libs/TinyGamepad.cjs",
       "import": "./dist/v1/libs/TinyGamepad.mjs"
@@ -235,6 +243,10 @@
     "./libs/TinyAdvancedRaffle": {
       "require": "./dist/v1/libs/TinyAdvancedRaffle.cjs",
       "import": "./dist/v1/libs/TinyAdvancedRaffle.mjs"
+    },
+    "./libs/TinyHtmlElems": {
+      "require": "./dist/v1/libs/TinyHtml/index.cjs",
+      "import": "./dist/v1/libs/TinyHtml/index.mjs"
     }
   },
   "repository": {
@@ -242,10 +254,6 @@
     "url": "git+https://github.com/JasminDreasond/Tiny-Essentials.git"
   },
   "keywords": [
-    "@tinypudding/firebase-lib",
-    "@tinypudding/discord-oauth2",
-    "@tinypudding/mysql-connector",
-    "@tinypudding/puddy-lib",
     "tiny-essentials",
     "timeout",
     "storage",
@@ -297,39 +305,22 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@types/jquery": "^3.5.32",
     "@types/lodash": "^4.17.16",
     "@types/md5": "^2.3.5",
     "@types/node-fetch": "^2.6.12",
-    "@types/tinycolor2": "^1.4.6",
     "babel-preset-es2015": "^6.24.1",
-    "byte-length": "^1.0.2",
-    "clone": "^2.1.2",
-    "compare-versions": "^6.1.1",
     "esbuild": "^0.25.5",
     "express": "^5.1.0",
-    "firebase": "^11.7.1",
-    "firebase-functions": "^6.3.2",
-    "jquery": "^3.7.1",
-    "jquery-ui": "^1.14.1",
-    "latest-version": "^9.0.0",
     "lodash": "^4.17.21",
     "marked": "^16.0.0",
-    "md5": "^2.3.0",
-    "moment": "^2.30.1",
-    "moment-timezone": "^0.5.48",
-    "mysql": "^2.18.1",
-    "node-fetch": "^2.7.0",
     "node-polyfill-webpack-plugin": "^4.1.0",
-    "object-hash": "^3.0.0",
-    "prettier": "3.5.3",
+    "prettier": "3.6.2",
     "rollup": "^4.40.0",
     "rollup-preserve-directives": "^1.1.3",
     "safe-stable-stringify": "^2.5.0",
     "sass": "^1.89.2",
-    "tinycolor2": "^1.6.0",
     "tslib": "^2.8.1",
-    "type-fest": "^4.40.0",
+    "type-fest": "^5.0.1",
     "typescript": "^5.8.3",
     "webpack": "^5.99.6",
     "webpack-cli": "^6.0.1"

package/dist/_virtual/_commonjsHelpers.cjs

@@ -1,7 +0,0 @@
-'use strict';
-
-function getDefaultExportFromCjs (x) {
-	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
-}
-
-exports.getDefaultExportFromCjs = getDefaultExportFromCjs;

package/dist/_virtual/common.cjs

@@ -1,5 +0,0 @@
-'use strict';
-
-var common = {};
-
-exports.__exports = common;

package/dist/_virtual/index.cjs

@@ -1,9 +0,0 @@
-'use strict';
-
-var _commonjsHelpers = require('./_commonjsHelpers.cjs');
-var index = require('../node_modules/firebase-functions/lib/logger/index.cjs');
-
-var loggerExports = index.__require();
-var logger = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(loggerExports);
-
-module.exports = logger;

package/dist/_virtual/index2.cjs

@@ -1,5 +0,0 @@
-'use strict';
-
-var logger = {};
-
-exports.__exports = logger;

package/dist/_virtual/trace.cjs

@@ -1,5 +0,0 @@
-'use strict';
-
-var trace = {};
-
-exports.__exports = trace;