tiny-essentials 1.24.1 → 1.24.2

package/changelog/1/24/1.md

@@ -10,3 +10,5 @@ We’ve simplified property access for better readability and consistency:
 * `el.id()` → `el.id`
 * `el.height()` → `el.height`
 * `el.width()` → `el.width`
+
+**Full Changelog**: https://github.com/JasminDreasond/Tiny-Essentials/compare/1.24.0...1.24.1

package/changelog/1/24/2.md

@@ -0,0 +1,21 @@
+### 📝 What’s New?
+
+In this update, we’ve added **new documentation** for the `exports` field in our `package.json`.
+This doc helps developers clearly understand how to import/require different parts of the package:
+
+* 🎨 **CSS Assets** → direct stylesheet imports
+* 🏠 **Root Entrypoints** → main, basics, libs, and fileManager
+* 🔧 **Basics Utilities** → array, clock, collision, fullScreen, etc.
+* 📚 **Libs Modules** → all individual helpers (TinyTextarea, TinyDragger, TinyNotify, and many more)
+
+### 🌟 Why does this matter?
+
+* Easier navigation of the package structure
+* Clearer examples for both **ESM (`import`)** and **CommonJS (`require`)**
+* Better developer experience 🚀
+
+### 📖 Docs
+
+You can now read the new Markdown guide in the repository to see the **full mapping** of exports.
+
+**Full Changelog**: https://github.com/JasminDreasond/Tiny-Essentials/compare/1.24.1...1.24.2

package/docs/v1/Exports.md

@@ -0,0 +1,133 @@
+# 📦 Package Exports Map
+
+This package provides multiple entry points depending on what you need.
+You can `import` (ESM) or `require` (CommonJS) each module individually.
+
+---
+
+## 🎨 CSS Assets
+
+These are pre-built stylesheets that can be directly imported:
+
+* `css/aiMarker.min.css` → `dist/v1/css/aiMarker.min.css`
+* `css/TinyCookieConsent.min.css` → `dist/v1/css/TinyCookieConsent.min.css`
+* `css/TinyDraggerExample.min.css` → `dist/v1/css/TinyDraggerExample.min.css`
+* `css/TinyNotify.min.css` → `dist/v1/css/TinyNotify.min.css`
+* `css/TinyLoadingScreen.min.css` → `dist/v1/css/TinyLoadingScreen.min.css`
+
+✅ Usage example:
+
+```js
+import "tiny-essentials/css/TinyNotify.min.css";
+```
+
+---
+
+## 🏠 Root Entrypoints
+
+* `.` → main entry
+
+  * `"require"` → `dist/v1/index.cjs`
+  * `"import"` → `dist/v1/index.mjs`
+
+* `libs` → all library helpers
+
+  * `"require"` → `dist/v1/libs/index.cjs`
+  * `"import"` → `dist/v1/libs/index.mjs`
+
+* `basics` → general utility functions
+
+  * `"require"` → `dist/v1/basics/index.cjs`
+  * `"import"` → `dist/v1/basics/index.mjs`
+
+* `fileManager` → file utilities
+
+  * `"require"` → `dist/v1/fileManager/index.cjs`
+  * `"import"` → `dist/v1/fileManager/index.mjs`
+
+---
+
+## 🔧 Basics Modules
+
+Direct access to smaller utilities:
+
+* `basics/array`
+* `basics/clock`
+* `basics/collision`
+* `basics/fullScreen`
+* `basics/html`
+* `basics/objChecker`
+* `basics/objFilter`
+* `basics/simpleMath`
+* `basics/text`
+
+Direct access to file utilities:
+
+* `fileManager/async`
+* `fileManager/normal`
+
+---
+
+## 📚 Libs Modules
+
+Each library can be imported separately:
+
+* **General Tools** 🛠
+
+  * `libs/ColorSafeStringify`
+  * `libs/UltraRandomMsgGen`
+  * `libs/TinyUploadClicker`
+  * `libs/TinyToastNotify`
+  * `libs/TinyTimeout`
+  * `libs/TinyTextRangeEditor`
+  * `libs/TinyTextarea`
+  * `libs/TinySmartScroller`
+  * `libs/TinySimpleDice`
+  * `libs/TinyRateLimiter`
+  * `libs/TinyPromiseQueue`
+  * `libs/TinyNotifyCenter`
+  * `libs/TinyNotifications`
+  * `libs/TinyNewWinEvents`
+  * `libs/TinyNeedBar`
+  * `libs/TinyLocalStorage`
+  * `libs/TinyLoadingScreen`
+  * `libs/TinyColorValidator`
+  * `libs/TinyInventoryTrader`
+  * `libs/TinyInventory`
+  * `libs/TinyIframeEvents`
+  * `libs/TinyI18`
+  * `libs/TinyLevelUp`
+  * `libs/TinyGamepad`
+  * `libs/TinyEvents`
+  * `libs/TinyElementObserver`
+  * `libs/TinyDragger`
+  * `libs/TinyDragDropDetector`
+  * `libs/TinyDomReadyManager`
+  * `libs/TinyDayNightCycle`
+  * `libs/TinyCookieConsent`
+  * `libs/TinyColorConverter`
+  * `libs/TinyClipboard`
+  * `libs/TinyArrayPaginator`
+  * `libs/TinyAfterScrollWatcher`
+  * `libs/TinyAdvancedRaffle`
+
+* **HTML Helpers** 🧩
+
+  * `libs/TinyHtml`
+  * `libs/TinyHtmlElems`
+
+---
+
+## ✅ Import Examples
+
+**ESM (modern projects)**
+
+```js
+import { TinyTextarea } from "tiny-essentials/libs/TinyTextarea";
+```
+
+**CommonJS (Node.js)**
+
+```js
+const { TinyTextarea } = require("tiny-essentials/libs/TinyTextarea");
+```

package/docs/v1/README.md

@@ -78,6 +78,8 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 
 To get started, navigate to the appropriate directory and explore the files listed. Each script includes detailed documentation on how to use the respective functionality.
 
+👉 For a complete overview of all available entry points and modules, please check out the [**exports**](./Exports.md) file. It provides a detailed map of the package’s `exports` and helps you import exactly what you need.
+
 ---
 
 ## 📖 More Regex Goodies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.24.1",
+  "version": "1.24.2",
   "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",
@@ -56,45 +56,53 @@
       "require": "./dist/v1/basics/index.cjs",
       "import": "./dist/v1/basics/index.mjs"
     },
-    "./fileManager": {
-      "require": "./dist/v1/fileManager/index.cjs",
-      "import": "./dist/v1/fileManager/index.mjs"
-    },
     "./basics/array": {
-      "require": "./dist/v1/libs/array.cjs",
-      "import": "./dist/v1/libs/array.mjs"
+      "require": "./dist/v1/basics/array.cjs",
+      "import": "./dist/v1/basics/array.mjs"
     },
     "./basics/clock": {
-      "require": "./dist/v1/libs/clock.cjs",
-      "import": "./dist/v1/libs/clock.mjs"
+      "require": "./dist/v1/basics/clock.cjs",
+      "import": "./dist/v1/basics/clock.mjs"
     },
     "./basics/collision": {
-      "require": "./dist/v1/libs/collision.cjs",
-      "import": "./dist/v1/libs/collision.mjs"
+      "require": "./dist/v1/basics/collision.cjs",
+      "import": "./dist/v1/basics/collision.mjs"
     },
     "./basics/fullScreen": {
-      "require": "./dist/v1/libs/fullScreen.cjs",
-      "import": "./dist/v1/libs/fullScreen.mjs"
+      "require": "./dist/v1/basics/fullScreen.cjs",
+      "import": "./dist/v1/basics/fullScreen.mjs"
     },
     "./basics/html": {
-      "require": "./dist/v1/libs/html.cjs",
-      "import": "./dist/v1/libs/html.mjs"
+      "require": "./dist/v1/basics/html.cjs",
+      "import": "./dist/v1/basics/html.mjs"
     },
     "./basics/objChecker": {
-      "require": "./dist/v1/libs/objChecker.cjs",
-      "import": "./dist/v1/libs/objChecker.mjs"
+      "require": "./dist/v1/basics/objChecker.cjs",
+      "import": "./dist/v1/basics/objChecker.mjs"
     },
     "./basics/objFilter": {
-      "require": "./dist/v1/libs/objFilter.cjs",
-      "import": "./dist/v1/libs/objFilter.mjs"
+      "require": "./dist/v1/basics/objFilter.cjs",
+      "import": "./dist/v1/basics/objFilter.mjs"
     },
     "./basics/simpleMath": {
-      "require": "./dist/v1/libs/simpleMath.cjs",
-      "import": "./dist/v1/libs/simpleMath.mjs"
+      "require": "./dist/v1/basics/simpleMath.cjs",
+      "import": "./dist/v1/basics/simpleMath.mjs"
     },
     "./basics/text": {
-      "require": "./dist/v1/libs/text.cjs",
-      "import": "./dist/v1/libs/text.mjs"
+      "require": "./dist/v1/basics/text.cjs",
+      "import": "./dist/v1/basics/text.mjs"
+    },
+    "./fileManager": {
+      "require": "./dist/v1/fileManager/index.cjs",
+      "import": "./dist/v1/fileManager/index.mjs"
+    },
+    "./fileManager/async": {
+      "require": "./dist/v1/fileManager/asyncFuncs.cjs",
+      "import": "./dist/v1/fileManager/asyncFuncs.mjs"
+    },
+    "./fileManager/normal": {
+      "require": "./dist/v1/fileManager/normalFuncs.cjs",
+      "import": "./dist/v1/fileManager/normalFuncs.mjs"
     },
     "./libs/ColorSafeStringify": {
       "require": "./dist/v1/libs/ColorSafeStringify.cjs",