tiny-essentials 1.14.0 → 1.15.0

package/dist/v1/basics/index.mjs

@@ -2,9 +2,10 @@ import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
 import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
 import { shuffleArray } from './array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
-import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, installWindowHiddenScript, readFileBlob, readBase64Blob, } from './html.mjs';
+import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, installWindowHiddenScript, readFileBlob, readBase64Blob, isInViewport, isScrolledIntoView, } from './html.mjs';
 import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, isJsonObject, } from './objFilter.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './fullScreen.mjs';
 import { formatBytes, genFibonacciSeq, getAge, getSimplePerc, ruleOfThree } from './simpleMath.mjs';
 import { addAiMarkerShortcut, safeTextTrim, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
-export { safeTextTrim, installWindowHiddenScript, genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './collision.mjs';
+export { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/index.cjs

@@ -21,6 +21,7 @@ var asyncFuncs = require('./fileManager/asyncFuncs.cjs');
 var TinyDragger = require('./libs/TinyDragger.cjs');
 var TinyDomReadyManager = require('./libs/TinyDomReadyManager.cjs');
 var TinyNotifications = require('./libs/TinyNotifications.cjs');
+var collision = require('./basics/collision.cjs');
 
 
 
@@ -67,6 +68,8 @@ exports.getHtmlElBordersWidth = html.getHtmlElBordersWidth;
 exports.getHtmlElMargin = html.getHtmlElMargin;
 exports.getHtmlElPadding = html.getHtmlElPadding;
 exports.installWindowHiddenScript = html.installWindowHiddenScript;
+exports.isInViewport = html.isInViewport;
+exports.isScrolledIntoView = html.isScrolledIntoView;
 exports.readBase64Blob = html.readBase64Blob;
 exports.readFileBlob = html.readFileBlob;
 exports.readJsonBlob = html.readJsonBlob;
@@ -103,3 +106,21 @@ exports.listFilesAsync = asyncFuncs.listFilesAsync;
 exports.TinyDragger = TinyDragger;
 exports.TinyDomReadyManager = TinyDomReadyManager;
 exports.TinyNotifications = TinyNotifications;
+exports.areElsCollBottom = collision.areElsCollBottom;
+exports.areElsCollLeft = collision.areElsCollLeft;
+exports.areElsCollPerfBottom = collision.areElsCollPerfBottom;
+exports.areElsCollPerfLeft = collision.areElsCollPerfLeft;
+exports.areElsCollPerfRight = collision.areElsCollPerfRight;
+exports.areElsCollPerfTop = collision.areElsCollPerfTop;
+exports.areElsCollRight = collision.areElsCollRight;
+exports.areElsCollTop = collision.areElsCollTop;
+exports.areElsColliding = collision.areElsColliding;
+exports.areElsPerfColliding = collision.areElsPerfColliding;
+exports.getElsCollDetails = collision.getElsCollDetails;
+exports.getElsCollDirDepth = collision.getElsCollDirDepth;
+exports.getElsCollOverlap = collision.getElsCollOverlap;
+exports.getElsCollOverlapPos = collision.getElsCollOverlapPos;
+exports.getElsColliding = collision.getElsColliding;
+exports.getElsPerfColliding = collision.getElsPerfColliding;
+exports.getElsRelativeCenterOffset = collision.getElsRelativeCenterOffset;
+exports.getRectCenter = collision.getRectCenter;

package/dist/v1/index.d.mts

@@ -8,6 +8,26 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { areElsCollTop } from './basics/collision.mjs';
+import { areElsCollBottom } from './basics/collision.mjs';
+import { areElsCollLeft } from './basics/collision.mjs';
+import { areElsCollRight } from './basics/collision.mjs';
+import { areElsCollPerfTop } from './basics/collision.mjs';
+import { areElsCollPerfBottom } from './basics/collision.mjs';
+import { areElsCollPerfLeft } from './basics/collision.mjs';
+import { areElsCollPerfRight } from './basics/collision.mjs';
+import { areElsColliding } from './basics/collision.mjs';
+import { areElsPerfColliding } from './basics/collision.mjs';
+import { getElsColliding } from './basics/collision.mjs';
+import { getElsPerfColliding } from './basics/collision.mjs';
+import { getElsCollOverlap } from './basics/collision.mjs';
+import { getElsCollOverlapPos } from './basics/collision.mjs';
+import { getRectCenter } from './basics/collision.mjs';
+import { getElsRelativeCenterOffset } from './basics/collision.mjs';
+import { getElsCollDirDepth } from './basics/collision.mjs';
+import { getElsCollDetails } from './basics/collision.mjs';
+import { isInViewport } from './basics/html.mjs';
+import { isScrolledIntoView } from './basics/html.mjs';
 import { safeTextTrim } from './basics/text.mjs';
 import { installWindowHiddenScript } from './basics/html.mjs';
 import { genFibonacciSeq } from './basics/simpleMath.mjs';
@@ -77,5 +97,5 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -12,11 +12,12 @@ import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import TinyNotifyCenter from './libs/TinyNotifyCenter.mjs';
 import TinyToastNotify from './libs/TinyToastNotify.mjs';
-import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, installWindowHiddenScript, readFileBlob, readBase64Blob, } from './basics/html.mjs';
+import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, installWindowHiddenScript, readFileBlob, readBase64Blob, isInViewport, isScrolledIntoView, } from './basics/html.mjs';
 import TinyDragDropDetector from './libs/TinyDragDropDetector.mjs';
 import { readJsonFile, writeJsonFile, ensureDirectory, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, getLatestBackupPath, } from './fileManager/normalFuncs.mjs';
 import { listFilesAsync, listDirsAsync, clearDirectoryAsync, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, } from './fileManager/asyncFuncs.mjs';
 import TinyDragger from './libs/TinyDragger.mjs';
 import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
 import TinyNotifications from './libs/TinyNotifications.mjs';
-export { TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './basics/collision.mjs';
+export { TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/docs/v1/README.md

@@ -20,6 +20,7 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 - 🔄 **[asyncReplace](./basics/asyncReplace.md)** — Asynchronously replaces matches in a string using a regex and an async function.
 - 🖼️ **[html](./basics/html.md)** — Utilities for handling DOM element interactions like collision detection and basic element manipulation.
 - 📺 **[fullScreen](./basics/fullScreen.md)** — A complete fullscreen API manager with detection, event handling, and cross-browser compatibility.
+- 🧱 **[collision](./basics/collision.md)** — Full-featured rectangle collision detection system with directional analysis, depth calculation, and center offset metrics.
 
 ### 2. **`libs/`**
 - 🗂️ **[TinyPromiseQueue](./libs/TinyPromiseQueue.md)** — A class that allows sequential execution of asynchronous tasks, supporting task delays, cancellation, and queue management.

package/docs/v1/basics/collision.md

@@ -0,0 +1,237 @@
+# 📦 Collision Detection Module
+
+This module provides a complete and flexible system for detecting collisions between rectangles (like DOM elements), extracting direction, depth, and center alignment data.
+
+---
+
+## 📐 Type Definitions
+
+### `Dirs`
+
+```ts
+'top' | 'bottom' | 'left' | 'right'
+```
+
+🔁 A direction relative to a rectangle. Represents one of the four cardinal sides.
+
+---
+
+### `CollDirs`
+
+```ts
+{
+  in: Dirs | 'center' | null;
+  x: Dirs | null;
+  y: Dirs | null;
+}
+```
+
+🚦 Represents all directional aspects of a collision:
+
+* `in`: Dominant entry direction (`null` if no collision, `'center'` if perfectly aligned).
+* `x`: Collision bias on X axis.
+* `y`: Collision bias on Y axis.
+
+---
+
+### `NegCollDirs`
+
+```ts
+{
+  x: Dirs | null;
+  y: Dirs | null;
+}
+```
+
+❌ Negative collision flags indicating **gap** instead of overlap.
+
+---
+
+### `CollData`
+
+```ts
+{
+  top: number;
+  bottom: number;
+  left: number;
+  right: number;
+}
+```
+
+📏 Collision depth (in pixels) from each side of `rect2` into `rect1`.
+
+* Positive values = overlap
+* Negative values = no collision (gap)
+
+---
+
+### `CollCenter`
+
+```ts
+{
+  x: number;
+  y: number;
+}
+```
+
+🎯 Offset from the center of `rect1` to the center of `rect2`.
+
+---
+
+### `ObjRect`
+
+```ts
+{
+  height: number;
+  width: number;
+  top: number;
+  bottom: number;
+  left: number;
+  right: number;
+}
+```
+
+📦 Generic rectangle object, similar to `DOMRect`.
+
+---
+
+## 🔍 Collision Checks
+
+### Loose Collision (Partial Overlap Only)
+
+| Function                         | Description                             |
+| -------------------------------- | --------------------------------------- |
+| `areElsCollTop(rect1, rect2)`    | `rect1` is **above** `rect2`            |
+| `areElsCollBottom(rect1, rect2)` | `rect1` is **below** `rect2`            |
+| `areElsCollLeft(rect1, rect2)`   | `rect1` is **left of** `rect2`          |
+| `areElsCollRight(rect1, rect2)`  | `rect1` is **right of** `rect2`         |
+| `areElsColliding(rect1, rect2)`  | Returns `true` if **any side overlaps** |
+
+---
+
+### Perfect Collision (Touch or Overlap)
+
+| Function                             | Description                                        |
+| ------------------------------------ | -------------------------------------------------- |
+| `areElsCollPerfTop(rect1, rect2)`    | `rect1` is **fully above** or touching `rect2`     |
+| `areElsCollPerfBottom(rect1, rect2)` | `rect1` is **fully below** or touching `rect2`     |
+| `areElsCollPerfLeft(rect1, rect2)`   | `rect1` is **fully left** or touching `rect2`      |
+| `areElsCollPerfRight(rect1, rect2)`  | `rect1` is **fully right** or touching `rect2`     |
+| `areElsPerfColliding(rect1, rect2)`  | Returns `true` if there's **any overlap or touch** |
+
+---
+
+### Collision Direction (Single Side Detection)
+
+| Function                            | Returns                                            |
+| ----------------------------------- | -------------------------------------------------- |
+| `getElsColliding(rect1, rect2)`     | `'left'`, `'right'`, `'top'`, `'bottom'` or `null` |
+| `getElsPerfColliding(rect1, rect2)` | Same as above, but includes **touch detection**    |
+
+---
+
+## 🔬 Overlap & Direction
+
+### `getElsCollOverlap(rect1, rect2)`
+
+📏 Returns the depth of overlap between two rectangles:
+
+```js
+{
+  overlapLeft,
+  overlapRight,
+  overlapTop,
+  overlapBottom
+}
+```
+
+---
+
+### `getElsCollOverlapPos({ overlapLeft, overlapRight, overlapTop, overlapBottom })`
+
+📍 Determines which axis and direction has the strongest collision.
+
+```js
+{
+  dirX: 'left' | 'right',
+  dirY: 'top' | 'bottom'
+}
+```
+
+---
+
+## 🎯 Center Detection
+
+### `getRectCenter(rect)`
+
+Returns the **center X and Y coordinates** of a rectangle.
+
+---
+
+### `getElsRelativeCenterOffset(rect1, rect2)`
+
+Returns the distance from `rect1`'s center to `rect2`'s center:
+
+```js
+{
+  x: number,
+  y: number
+}
+```
+
+✅ Values are `0` when centers are aligned.
+
+---
+
+## 🧠 Direction & Depth
+
+### `getElsCollDirDepth(rect1, rect2)`
+
+Detects:
+
+* Which axis has the dominant collision
+* Overlap depths
+
+```js
+{
+  inDir: 'left' | 'right' | 'top' | 'bottom' | null,
+  dirX: 'left' | 'right' | null,
+  dirY: 'top' | 'bottom' | null,
+  depthX: number,
+  depthY: number
+}
+```
+
+---
+
+### `getElsCollDetails(rect1, rect2)`
+
+🔍 Full analysis of the collision:
+
+* Depth of overlap
+* Direction of entry
+* Negative axis gaps
+* Center hit detection
+
+```js
+{
+  depth: CollData,
+  dirs: CollDirs,
+  isNeg: NegCollDirs
+}
+```
+
+---
+
+## 🧪 Example Use
+
+```js
+const box = element1.getBoundingClientRect();
+const wall = element2.getBoundingClientRect();
+
+const result = getElsCollDetails(box, wall);
+
+console.log(result.depth); // { top, bottom, left, right }
+console.log(result.dirs.in); // e.g. 'left'
+console.log(result.isNeg); // e.g. { x: 'left', y: null }
+```

package/docs/v1/basics/html.md

@@ -136,7 +136,7 @@ input.addEventListener('change', async () => {
 
 ### 📖 `readJsonBlob(file: File): Promise<any>`
 
-Reads and parses a JSON file using the [`FileReader`](https://developer.mozilla.org/en-US/docs/Web/API/FileReader) API.
+Reads and parses a JSON file using the FileReader API.
 
 #### 📥 Parameters
 
@@ -279,6 +279,32 @@ getHtmlElBordersWidth(el: Element): HtmlElBoxSides
 
 ---
 
+### 👁️ `isInViewport(element)`
+
+🔍 Checks if an element is **partially visible** in the current viewport.
+
+```js
+isInViewport(element: HTMLElement): boolean
+```
+
+* `element`: The DOM element to check.
+* **Returns**: `true` if the element is at least partially visible; `false` otherwise.
+
+---
+
+### ✅ `isScrolledIntoView(element)`
+
+📦 Checks if an element is **fully visible** (top and bottom) within the viewport.
+
+```js
+isScrolledIntoView(element: HTMLElement): boolean
+```
+
+* `element`: The DOM element to check.
+* **Returns**: `true` if the entire element is within the viewport; `false` otherwise.
+
+---
+
 ### 🔳 `getHtmlElBorders(el)`
 
 📐 Returns the total **border size** of an element using `border{Side}` shorthand values from computed styles.

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "tiny-essentials",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "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",
     "test:js": "npx babel-node test/index.js",
     "test:cjs": "node test/index.cjs",
     "test:mjs": "node test/index.mjs",
+    "test:mjs:web": "node test/express.mjs",
     "test:mjs:promisequeue": "node test/index.mjs promiseQueue",
     "test:mjs:objtype": "node test/index.mjs objType",
     "test:mjs:jsoncolor": "node test/index.mjs colorStringify",
@@ -97,11 +98,13 @@
     "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",
     "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",
@@ -113,7 +116,7 @@
     "rollup": "^4.40.0",
     "rollup-preserve-directives": "^1.1.3",
     "safe-stable-stringify": "^2.5.0",
-    "sass": "^1.87.0",
+    "sass": "^1.89.2",
     "tinycolor2": "^1.6.0",
     "tslib": "^2.8.1",
     "type-fest": "^4.40.0",