tiny-essentials 1.18.0 → 1.18.1

package/dist/v1/basics/objChecker.d.mts

@@ -0,0 +1,29 @@
+/**
+ * Counts the number of elements in an array or the number of properties in an object.
+ *
+ * @param {Array<*>|Record<string | number | symbol, any>} obj - The array or object to count.
+ * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
+ *
+ * @example
+ * countObj([1, 2, 3]); // 3
+ * countObj({ a: 1, b: 2 }); // 2
+ * countObj('not an object'); // 0
+ */
+export function countObj(obj: Array<any> | Record<string | number | symbol, any>): number;
+/**
+ * Determines whether a given value is a pure JSON object (plain object).
+ *
+ * A pure object satisfies the following:
+ * - It is not null.
+ * - Its type is "object".
+ * - Its internal [[Class]] is "[object Object]".
+ * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
+ *
+ * This function is useful for strict data validation when you want to ensure
+ * a value is a clean JSON-compatible object, free of class instances or special types.
+ *
+ * @param {unknown} value - The value to test.
+ * @returns {value is Record<string | number | symbol, unknown>} Returns true if the value is a pure object.
+ */
+export function isJsonObject(value: unknown): value is Record<string | number | symbol, unknown>;
+//# sourceMappingURL=objChecker.d.mts.map

package/dist/v1/basics/objChecker.mjs

@@ -0,0 +1,45 @@
+/**
+ * Counts the number of elements in an array or the number of properties in an object.
+ *
+ * @param {Array<*>|Record<string | number | symbol, any>} obj - The array or object to count.
+ * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
+ *
+ * @example
+ * countObj([1, 2, 3]); // 3
+ * countObj({ a: 1, b: 2 }); // 2
+ * countObj('not an object'); // 0
+ */
+export function countObj(obj) {
+    // Is Array
+    if (Array.isArray(obj))
+        return obj.length;
+    // Object
+    if (isJsonObject(obj))
+        return Object.keys(obj).length;
+    // Nothing
+    return 0;
+}
+/**
+ * Determines whether a given value is a pure JSON object (plain object).
+ *
+ * A pure object satisfies the following:
+ * - It is not null.
+ * - Its type is "object".
+ * - Its internal [[Class]] is "[object Object]".
+ * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
+ *
+ * This function is useful for strict data validation when you want to ensure
+ * a value is a clean JSON-compatible object, free of class instances or special types.
+ *
+ * @param {unknown} value - The value to test.
+ * @returns {value is Record<string | number | symbol, unknown>} Returns true if the value is a pure object.
+ */
+export function isJsonObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    if (Array.isArray(value))
+        return false;
+    if (Object.prototype.toString.call(value) !== '[object Object]')
+        return false;
+    return true;
+}

package/dist/v1/basics/objFilter.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var buffer = require('buffer');
+var objChecker = require('./objChecker.cjs');
 
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
 
@@ -194,48 +195,6 @@ function getCheckObj() {
   return Object.fromEntries(Object.entries(typeValidator.items).map(([key, fn]) => [key, fn]));
 }
 
-/**
- * Counts the number of elements in an array or the number of properties in an object.
- *
- * @param {Array<*>|Record<string|number, any>} obj - The array or object to count.
- * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
- *
- * @example
- * countObj([1, 2, 3]); // 3
- * countObj({ a: 1, b: 2 }); // 2
- * countObj('not an object'); // 0
- */
-function countObj(obj) {
-  // Is Array
-  if (Array.isArray(obj)) return obj.length;
-  // Object
-  if (objType(obj, 'object')) return Object.keys(obj).length;
-  // Nothing
-  return 0;
-}
-
-/**
- * Determines whether a given value is a pure JSON object (plain object).
- *
- * A pure object satisfies the following:
- * - It is not null.
- * - Its type is "object".
- * - Its internal [[Class]] is "[object Object]".
- * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
- *
- * This function is useful for strict data validation when you want to ensure
- * a value is a clean JSON-compatible object, free of class instances or special types.
- *
- * @param {unknown} value - The value to test.
- * @returns {value is Record<string | number | symbol, unknown>} Returns true if the value is a pure object.
- */
-function isJsonObject(value) {
-  if (value === null || typeof value !== 'object') return false;
-  if (Array.isArray(value)) return false;
-  if (Object.prototype.toString.call(value) !== '[object Object]') return false;
-  return true;
-}
-
 // Insert obj types
 
 extendObjType([
@@ -358,15 +317,15 @@ extendObjType([
   [
     'object',
     /** @param {*} val @returns {val is Record<string | number | symbol, unknown>} */
-    (val) => isJsonObject(val),
+    (val) => objChecker.isJsonObject(val),
   ],
 ]);
 
+exports.countObj = objChecker.countObj;
+exports.isJsonObject = objChecker.isJsonObject;
 exports.checkObj = checkObj;
 exports.cloneObjTypeOrder = cloneObjTypeOrder;
-exports.countObj = countObj;
 exports.extendObjType = extendObjType;
 exports.getCheckObj = getCheckObj;
-exports.isJsonObject = isJsonObject;
 exports.objType = objType;
 exports.reorderObjTypeOrder = reorderObjTypeOrder;

package/dist/v1/basics/objFilter.d.mts

@@ -76,36 +76,11 @@ export function checkObj(obj: any): {
 export function getCheckObj(): {
     [k: string]: any;
 };
-/**
- * Counts the number of elements in an array or the number of properties in an object.
- *
- * @param {Array<*>|Record<string|number, any>} obj - The array or object to count.
- * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
- *
- * @example
- * countObj([1, 2, 3]); // 3
- * countObj({ a: 1, b: 2 }); // 2
- * countObj('not an object'); // 0
- */
-export function countObj(obj: Array<any> | Record<string | number, any>): number;
-/**
- * Determines whether a given value is a pure JSON object (plain object).
- *
- * A pure object satisfies the following:
- * - It is not null.
- * - Its type is "object".
- * - Its internal [[Class]] is "[object Object]".
- * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
- *
- * This function is useful for strict data validation when you want to ensure
- * a value is a clean JSON-compatible object, free of class instances or special types.
- *
- * @param {unknown} value - The value to test.
- * @returns {value is Record<string | number | symbol, unknown>} Returns true if the value is a pure object.
- */
-export function isJsonObject(value: unknown): value is Record<string | number | symbol, unknown>;
 export type ExtendObjType = {
     [x: string]: (val: any) => any;
 };
 export type ExtendObjTypeArray = Array<[string, (val: any) => any]>;
+import { countObj } from './objChecker.mjs';
+import { isJsonObject } from './objChecker.mjs';
+export { countObj, isJsonObject };
 //# sourceMappingURL=objFilter.d.mts.map

package/dist/v1/basics/objFilter.mjs

@@ -1,4 +1,6 @@
 import { Buffer } from 'buffer';
+import { countObj, isJsonObject } from './objChecker.mjs';
+export { countObj, isJsonObject };
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
 /**
  * An object containing type validation functions and their evaluation order.
@@ -176,51 +178,6 @@ export function checkObj(obj) {
 export function getCheckObj() {
     return Object.fromEntries(Object.entries(typeValidator.items).map(([key, fn]) => [key, fn]));
 }
-/**
- * Counts the number of elements in an array or the number of properties in an object.
- *
- * @param {Array<*>|Record<string|number, any>} obj - The array or object to count.
- * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
- *
- * @example
- * countObj([1, 2, 3]); // 3
- * countObj({ a: 1, b: 2 }); // 2
- * countObj('not an object'); // 0
- */
-export function countObj(obj) {
-    // Is Array
-    if (Array.isArray(obj))
-        return obj.length;
-    // Object
-    if (objType(obj, 'object'))
-        return Object.keys(obj).length;
-    // Nothing
-    return 0;
-}
-/**
- * Determines whether a given value is a pure JSON object (plain object).
- *
- * A pure object satisfies the following:
- * - It is not null.
- * - Its type is "object".
- * - Its internal [[Class]] is "[object Object]".
- * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
- *
- * This function is useful for strict data validation when you want to ensure
- * a value is a clean JSON-compatible object, free of class instances or special types.
- *
- * @param {unknown} value - The value to test.
- * @returns {value is Record<string | number | symbol, unknown>} Returns true if the value is a pure object.
- */
-export function isJsonObject(value) {
-    if (value === null || typeof value !== 'object')
-        return false;
-    if (Array.isArray(value))
-        return false;
-    if (Object.prototype.toString.call(value) !== '[object Object]')
-        return false;
-    return true;
-}
 // Insert obj types
 extendObjType([
     [

package/dist/v1/index.cjs

@@ -6,6 +6,7 @@ var arraySortPositions = require('../legacy/libs/arraySortPositions.cjs');
 var array = require('./basics/array.cjs');
 var clock = require('./basics/clock.cjs');
 var objFilter = require('./basics/objFilter.cjs');
+var objChecker = require('./basics/objChecker.cjs');
 var fullScreen = require('./basics/fullScreen.cjs');
 var simpleMath = require('./basics/simpleMath.cjs');
 var text = require('./basics/text.cjs');
@@ -42,11 +43,11 @@ exports.formatTimer = clock.formatTimer;
 exports.getTimeDuration = clock.getTimeDuration;
 exports.checkObj = objFilter.checkObj;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
-exports.countObj = objFilter.countObj;
 exports.extendObjType = objFilter.extendObjType;
-exports.isJsonObject = objFilter.isJsonObject;
 exports.objType = objFilter.objType;
 exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
+exports.countObj = objChecker.countObj;
+exports.isJsonObject = objChecker.isJsonObject;
 exports.documentIsFullScreen = fullScreen.documentIsFullScreen;
 exports.exitFullScreen = fullScreen.exitFullScreen;
 exports.isFullScreenMode = fullScreen.isFullScreenMode;

package/dist/v1/index.d.mts

@@ -82,14 +82,14 @@ import { isFullScreenMode } from './basics/fullScreen.mjs';
 import { onFullScreenChange } from './basics/fullScreen.mjs';
 import { offFullScreenChange } from './basics/fullScreen.mjs';
 import { areHtmlElsColliding } from './basics/html_deprecated.mjs';
-import { isJsonObject } from './basics/objFilter.mjs';
+import { isJsonObject } from './basics/objChecker.mjs';
 import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { formatBytes } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut } from './basics/text.mjs';
 import { extendObjType } from './basics/objFilter.mjs';
 import { reorderObjTypeOrder } from './basics/objFilter.mjs';
 import { cloneObjTypeOrder } from './basics/objFilter.mjs';
-import { countObj } from './basics/objFilter.mjs';
+import { countObj } from './basics/objChecker.mjs';
 import { checkObj } from './basics/objFilter.mjs';
 import { objType } from './basics/objFilter.mjs';
 import { ruleOfThree } from './basics/simpleMath.mjs';

package/dist/v1/index.mjs

@@ -3,7 +3,8 @@ import TinyLevelUp from '../legacy/libs/userLevel.mjs';
 import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
-import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, isJsonObject, } from './basics/objFilter.mjs';
+import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, } from './basics/objFilter.mjs';
+import { countObj, isJsonObject } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './basics/fullScreen.mjs';
 import { formatBytes, genFibonacciSeq, getAge, getSimplePerc, ruleOfThree, } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, } from './basics/text.mjs';

package/dist/v1/libs/TinyDragger.cjs

@@ -2,7 +2,7 @@
 
 var TinyHtml = require('./TinyHtml.cjs');
 var collision = require('../basics/collision.cjs');
-var objFilter = require('../basics/objFilter.cjs');
+var objChecker = require('../basics/objChecker.cjs');
 
 /**
  * @typedef {Object} VibrationPatterns
@@ -97,7 +97,7 @@ class TinyDragger {
     if (
       options.vibration !== undefined &&
       options.vibration !== false &&
-      !objFilter.isJsonObject(options.vibration)
+      !objChecker.isJsonObject(options.vibration)
     )
       throw new Error('The "vibration" option must be an object or false.');
 
@@ -141,7 +141,7 @@ class TinyDragger {
     const vibrationTemplate = { start: false, end: false, collide: false, move: false };
     this.#vibration = Object.assign(
       vibrationTemplate,
-      objFilter.isJsonObject(options.vibration) ? options.vibration : {},
+      objChecker.isJsonObject(options.vibration) ? options.vibration : {},
     );
 
     if (typeof options.classDragging === 'string') this.#classDragging = options.classDragging;

package/dist/v1/libs/TinyDragger.mjs

@@ -1,6 +1,6 @@
 import TinyHtml from './TinyHtml.mjs';
 import * as TinyCollision from '../basics/collision.mjs';
-import { isJsonObject } from '../basics/objFilter.mjs';
+import { isJsonObject } from '../basics/objChecker.mjs';
 /**
  * @typedef {Object} VibrationPatterns
  * @property {number[]|false} start - Pattern to vibrate on start

package/dist/v1/libs/TinyUploadClicker.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var objFilter = require('../basics/objFilter.cjs');
+require('../basics/objFilter.cjs');
+var objChecker = require('../basics/objChecker.cjs');
 require('./TinyHtml.cjs');
 require('fs');
 require('path');
@@ -79,7 +80,7 @@ class TinyUploadClicker {
    * @throws {TypeError} If the config is invalid or required options are missing.
    */
   constructor(options) {
-    if (!objFilter.isJsonObject(options))
+    if (!objChecker.isJsonObject(options))
       throw new TypeError('TinyUploadClicker: "options" must be a valid object.');
 
     this.#config = {
@@ -145,10 +146,10 @@ class TinyUploadClicker {
     )
       throw new TypeError('TinyUploadClicker: "onFileLoad" must be a function or null.');
 
-    if (options.inputAttributes !== undefined && !objFilter.isJsonObject(options.inputAttributes))
+    if (options.inputAttributes !== undefined && !objChecker.isJsonObject(options.inputAttributes))
       throw new TypeError('TinyUploadClicker: "inputAttributes" must be an object.');
 
-    if (options.inputStyles !== undefined && !objFilter.isJsonObject(options.inputStyles))
+    if (options.inputStyles !== undefined && !objChecker.isJsonObject(options.inputStyles))
       throw new TypeError('TinyUploadClicker: "inputStyles" must be an object.');
 
     this.#boundClick = this.#handleClick.bind(this);

package/docs/v1/README.md

@@ -15,6 +15,7 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 - 📦 **[Array](./basics/array.md)** — A tiny utility for shuffling arrays using the Fisher–Yates algorithm.
 - ⏰ **[Clock](./basics/clock.md)** — A versatile time utility module for calculating and formatting time durations.
 - 🧠 **[ObjFilter](./basics/objFilter.md)** — Type detection, extension, and analysis made easy with simple and extensible type validation.
+* 🧮 **[objChecker](./basics/objChecker.md)** — Utilities for counting keys in objects or arrays and for safely detecting plain JSON-compatible objects.
 - 🔢 **[SimpleMath](./basics/simpleMath.md)** — A collection of simple math utilities for calculations like the Rule of Three and percentages.
 - ✍️ **[Text](./basics/text.md)** — A utility for transforming text into title case formats, with multiple options for capitalization.
 - 🔄 **[AsyncReplace](./basics/asyncReplace.md)** — Asynchronously replaces matches in a string using a regex and an async function.

package/docs/v1/basics/objChecker.md

@@ -0,0 +1,47 @@
+# 🧠 objChecker.mjs
+
+## 📘 Object & Type Utilities
+
+This document introduces utility functions designed to help you safely and efficiently work with JavaScript objects and types. These helpers are particularly useful when dealing with dynamic values — especially in situations where data might be coming from APIs, user input, or JSON files.
+
+These tools are built to reduce boilerplate code and prevent common mistakes when handling unknown or loosely-typed values in JavaScript.
+
+---
+
+### 🧮 `countObj(obj)`
+
+Returns the number of elements in an array or the number of keys in an object.
+
+```js
+countObj([1, 2, 3]);       // 3
+countObj({ a: 1, b: 2 });  // 2
+countObj('hi');            // 0
+```
+
+---
+
+### 🧼 `isJsonObject(value)`
+
+Check if a value is a **plain JSON-compatible object** — meaning it's created via `{}` or `new Object()`, with a prototype of `Object.prototype`, and **not** a special object like `Date`, `Map`, `Array`, etc.
+
+```js
+isJsonObject({}); // true
+isJsonObject(Object.create({})); // true
+isJsonObject(Object.create(Object.prototype)); // true
+isJsonObject(Object.assign({}, { a: 1 })); // true
+```
+
+```js
+isJsonObject([]); // false
+isJsonObject(new Date()); // false
+isJsonObject(new Map()); // false
+isJsonObject(Object.create(null)); // false
+```
+
+🔒 This function ensures the object:
+
+* is not `null`
+* has `typeof === 'object'`
+* is **directly** inherited from `Object.prototype`
+
+Use this when you need to strictly validate a raw JSON object (like the output of `JSON.parse()` or manual object literals).

package/docs/v1/basics/objFilter.md

@@ -121,18 +121,6 @@ const currentOrder = cloneObjTypeOrder();
 
 ---
 
-### 🧮 `countObj(obj)`
-
-Returns the number of elements in an array or the number of keys in an object.
-
-```js
-countObj([1, 2, 3]);       // 3
-countObj({ a: 1, b: 2 });  // 2
-countObj('hi');            // 0
-```
-
----
-
 ## Supported Types
 
 Here’s a full list of supported type names (in their default order):
@@ -164,31 +152,3 @@ You can change this order or insert your own types with `extendObjType`.
 ### 🛠️ `getCheckObj()`
 
 This function creates a clone of the functions from the `typeValidator` object. It returns a new object where the keys are the same and the values are the cloned functions.
-
----
-
-### 🧼 `isJsonObject(value)`
-
-Check if a value is a **plain JSON-compatible object** — meaning it's created via `{}` or `new Object()`, with a prototype of `Object.prototype`, and **not** a special object like `Date`, `Map`, `Array`, etc.
-
-```js
-isJsonObject({}); // true
-isJsonObject(Object.create({})); // true
-isJsonObject(Object.create(Object.prototype)); // true
-isJsonObject(Object.assign({}, { a: 1 })); // true
-```
-
-```js
-isJsonObject([]); // false
-isJsonObject(new Date()); // false
-isJsonObject(new Map()); // false
-isJsonObject(Object.create(null)); // false
-```
-
-🔒 This function ensures the object:
-
-* is not `null`
-* has `typeof === 'object'`
-* is **directly** inherited from `Object.prototype`
-
-Use this when you need to strictly validate a raw JSON object (like the output of `JSON.parse()` or manual object literals).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.18.0",
+  "version": "1.18.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",

package/dist/v1/TinyDragger.min.js.LICENSE.txt

@@ -1,8 +0,0 @@
-/*!
- * The buffer module from node.js, for the browser.
- *
- * @author   Feross Aboukhadijeh <https://feross.org>
- * @license  MIT
- */
-
-/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */