@k37z3r/jbase 2.0.0

package/README.md

@@ -0,0 +1,124 @@
+# jBase
+
+![Version](https://img.shields.io/badge/version-2.0.0-blue.svg?style=flat-square)
+![License](https://img.shields.io/badge/license-GPL--3.0-green.svg?style=flat-square)
+![Size](https://img.shields.io/badge/size-lightweight-orange.svg?style=flat-square)
+![Build](https://img.shields.io/badge/build-passing-brightgreen.svg?style=flat-square)
+
+**A modern, lightweight, and modular JavaScript framework for high-performance DOM manipulation, event handling, and data management.**
+
+jBase offers a familiar chainable API (similar to jQuery) but is built on modern ES6+ standards. It goes beyond UI logic by including a robust set of immutable data utilities for handling complex arrays and objects.
+
+---
+
+## 📥 Installation
+
+### via NPM / Yarn (coming soon)
+Ideal for modern web apps using bundlers like Webpack, Vite, or Rollup.
+
+```bash
+npm install jbase
+# or
+yarn add jbase
+
+```
+
+### via Script Tag (CDN)
+
+Simply download the minified file and include it in your HTML.
+
+```html
+<script src="dist/jbase.min.js"></script>
+
+```
+
+---
+
+## 🚀 Quick Start
+
+jBase exposes itself globally as `jBase` and the shorthand `$`.
+
+### 1. DOM Manipulation & Events
+
+```javascript
+import { $ } from 'jbase';
+
+$(document).ready(() => {
+    // Select elements and modify CSS
+    $('.card').css({ 
+        'background-color': '#f8f9fa',
+        'border-radius': '8px' 
+    });
+
+    // Handle events
+    $('#save-btn').on('click', (e) => {
+        e.preventDefault();
+        $('.status').text('Saved successfully!').fadeIn(300);
+    });
+});
+
+```
+
+### 2. Powerful Data Utilities
+
+jBase includes a unique `$.data` module for **immutable** array and object manipulation.
+
+```javascript
+const users = [
+    { id: 1, name: 'Alice', role: 'admin' },
+    { id: 2, name: 'Bob', role: 'user' }
+];
+
+// Find specific data efficiently
+const admin = $.data.find.first(users, 'admin', 'exact', 'role');
+
+// Remove data immutably (returns a new array)
+const nonAdmins = $.data.remove.byMatch(users, 'admin', 'exact', 'role');
+
+```
+
+### 3. HTTP Requests
+
+Simple, Promise-based AJAX wrappers.
+
+```javascript
+$.http.get('https://api.example.com/items')
+    .then(data => console.log('Items loaded:', data))
+    .catch(err => console.error('Error:', err));
+
+```
+
+---
+
+## 📚 Documentation
+
+Detailed documentation for all methods is available in the **[GitHub Wiki](../../wiki)**.
+
+
+---
+
+## 🛠 Usage in Node.js
+
+jBase can be used in Node.js environments. Note that DOM-related methods require a window context (like jsdom), but **Data** and **HTTP** utilities work natively.
+
+```javascript
+const { $ } = require('jbase');
+
+// Use Data Utils on the server side
+const merged = $.data.mergeObjects({ a: 1 }, { b: 2 });
+
+```
+
+---
+
+## ©️ License & Author
+
+**jBase** is open-source software licensed under the **[GPL-3.0-or-later](LICENSE)**.
+
+**Author:** Sven Minio
+
+**Website:** [sven-minio.de](https://sven-minio.de)
+
+**Copyright:** © 2026 Sven Minio
+
+```

package/dist/browser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file src/browser.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Browser
+ * @description
+ * * 🇬🇧: Browser Entry Point. Attaches the jBase library and utilities to the global window object so they can be accessed via `$` or `jBase` in inline scripts.
+ * * 🇩🇪: Browser-Einstiegspunkt. Hängt die jBase-Bibliothek und Utilities an das globale Window-Objekt an, damit sie über `$` oder `jBase` in Inline-Skripten verfügbar sind.
+ */
+import { $, jBase, http, jB, _jB, __jB, _jBase, __jBase } from './index';
+/**
+ * * 🇬🇧: TypeScript declaration merging to extend the global Window interface.
+ * * 🇩🇪: TypeScript Declaration Merging zur Erweiterung des globalen Window-Interfaces.
+ */
+declare global {
+    interface Window {
+        $: typeof $;
+        jBase: typeof jBase;
+        jB: typeof jB;
+        _jB: typeof _jB;
+        __jB: typeof __jB;
+        _jBase: typeof _jBase;
+        __jBase: typeof __jBase;
+        http: typeof http;
+    }
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzE;;;GAGG;AACH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,EAAE,EAAE,OAAO,EAAE,CAAC;QACd,GAAG,EAAE,OAAO,GAAG,CAAC;QAChB,IAAI,EAAE,OAAO,IAAI,CAAC;QAClB,MAAM,EAAE,OAAO,MAAM,CAAC;QACtB,OAAO,EAAE,OAAO,OAAO,CAAC;QACxB,IAAI,EAAE,OAAO,IAAI,CAAC;KACrB;CACJ"}

package/dist/browser.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @file src/browser.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Browser
+ * @description
+ * * 🇬🇧: Browser Entry Point. Attaches the jBase library and utilities to the global window object so they can be accessed via `$` or `jBase` in inline scripts.
+ * * 🇩🇪: Browser-Einstiegspunkt. Hängt die jBase-Bibliothek und Utilities an das globale Window-Objekt an, damit sie über `$` oder `jBase` in Inline-Skripten verfügbar sind.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * * 🇬🇧: Expose globals to the window object.
+ * * 🇩🇪: Globale Variablen auf dem Window-Objekt setzen.
+ */
+window.$ = index_1.$;
+window.jBase = index_1.jBase;
+window.jB = index_1.jB;
+window._jB = index_1._jB;
+window.__jB = index_1.__jB;
+window._jBase = index_1._jBase;
+window.__jBase = index_1.__jBase;
+window.http = index_1.http;
+console.log("jBase initialized and ready!");
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAEH,mCAAyE;AAmBzE;;;GAGG;AACF,MAAc,CAAC,CAAC,GAAG,SAAC,CAAC;AACrB,MAAc,CAAC,KAAK,GAAG,aAAK,CAAC;AAC7B,MAAc,CAAC,EAAE,GAAG,UAAE,CAAC;AACvB,MAAc,CAAC,GAAG,GAAG,WAAG,CAAC;AACzB,MAAc,CAAC,IAAI,GAAG,YAAI,CAAC;AAC3B,MAAc,CAAC,MAAM,GAAG,cAAM,CAAC;AAC/B,MAAc,CAAC,OAAO,GAAG,eAAO,CAAC;AACjC,MAAc,CAAC,IAAI,GAAG,YAAI,CAAC;AAE5B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC"}

package/dist/core.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file src/core.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Core
+ * @description
+ * * 🇬🇧: The main jBase class. Handles the selection engine, initialization, and plugin architecture.
+ * * 🇩🇪: Die Haupt-jBase-Klasse. Behandelt die Selektions-Engine, Initialisierung und Plugin-Architektur.
+ */
+import { JBaseElement, JBaseInput } from './types';
+/**
+ * * 🇬🇧: The core class of the framework, inheriting from the native Array class. Acts as a wrapper around DOM elements and enables chainable methods (Fluent Interface).
+ * * 🇩🇪: Die Kern-Klasse des Frameworks, die von der nativen Array-Klasse erbt. Dient als Wrapper um DOM-Elemente und ermöglicht verkettbare Methoden (Fluent Interface).
+ */
+export declare class jBase extends Array<JBaseElement> {
+    selectorSource: string;
+    /**
+     * * 🇬🇧: Initializes a new jBase instance. Analyzes the provided selector and populates the internal array with found or created DOM elements.
+     * * 🇩🇪: Initialisiert eine neue jBase-Instanz. Analysiert den übergebenen Selektor und füllt das interne Array mit den gefundenen oder erstellten DOM-Elementen.
+     * @param selector
+     * * 🇬🇧: The input selector (CSS selector, HTML string, DOM element, or collection).
+     * * 🇩🇪: Der Eingabe-Selektor (CSS-Selektor, HTML-String, DOM-Element oder Sammlung).
+     */
+    constructor(selector?: JBaseInput);
+    /**
+     * * 🇬🇧: Custom serializer for JSON.stringify. Prevents circular references and huge outputs by returning a simplified preview.
+     * * 🇩🇪: Benutzerdefinierte Serialisierung für JSON.stringify. Verhindert Zirkelbezüge und riesige Ausgaben durch Rückgabe einer vereinfachten Vorschau.
+     * @returns
+     * * 🇬🇧: A simplified object representation for debugging.
+     * * 🇩🇪: Eine vereinfachte Objektrepräsentation für das Debugging.
+     */
+    toJSON(): {
+        meta: string;
+        query: string;
+        count: number;
+        preview: string[];
+    };
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD;;;GAGG;AACH,qBAAa,KAAM,SAAQ,KAAK,CAAC,YAAY,CAAC;IACnC,cAAc,EAAE,MAAM,CAAM;IAEnC;;;;;;OAMG;gBACS,QAAQ,CAAC,EAAE,UAAU;IAgCjC;;;;;;OAMG;IACH,MAAM;;;;;;CAYT"}

package/dist/core.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * @file src/core.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Core
+ * @description
+ * * 🇬🇧: The main jBase class. Handles the selection engine, initialization, and plugin architecture.
+ * * 🇩🇪: Die Haupt-jBase-Klasse. Behandelt die Selektions-Engine, Initialisierung und Plugin-Architektur.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jBase = void 0;
+/**
+ * * 🇬🇧: The core class of the framework, inheriting from the native Array class. Acts as a wrapper around DOM elements and enables chainable methods (Fluent Interface).
+ * * 🇩🇪: Die Kern-Klasse des Frameworks, die von der nativen Array-Klasse erbt. Dient als Wrapper um DOM-Elemente und ermöglicht verkettbare Methoden (Fluent Interface).
+ */
+class jBase extends Array {
+    /**
+     * * 🇬🇧: Initializes a new jBase instance. Analyzes the provided selector and populates the internal array with found or created DOM elements.
+     * * 🇩🇪: Initialisiert eine neue jBase-Instanz. Analysiert den übergebenen Selektor und füllt das interne Array mit den gefundenen oder erstellten DOM-Elementen.
+     * @param selector
+     * * 🇬🇧: The input selector (CSS selector, HTML string, DOM element, or collection).
+     * * 🇩🇪: Der Eingabe-Selektor (CSS-Selektor, HTML-String, DOM-Element oder Sammlung).
+     */
+    constructor(selector) {
+        super();
+        this.selectorSource = '';
+        this.selectorSource = typeof selector === 'string' ? selector : '<DOM Object/Array>';
+        if (!selector)
+            return;
+        // 1. Single DOM Element / Window / Document
+        if (selector instanceof HTMLElement || selector === document || selector === window || selector instanceof Element) {
+            this.push(selector);
+        }
+        // 2. String (HTML Creation or CSS Selector)
+        else if (typeof selector === 'string') {
+            const trimmed = selector.trim();
+            if (trimmed.startsWith('<') && trimmed.endsWith('>')) {
+                // HTML Creation
+                const tempDiv = document.createElement('div');
+                tempDiv.innerHTML = trimmed;
+                this.push(...Array.from(tempDiv.children));
+            }
+            else {
+                // CSS Selector
+                this.push(...Array.from(document.querySelectorAll(selector)));
+            }
+        }
+        // 3. Collections (NodeList, Array)
+        else if (selector instanceof NodeList || Array.isArray(selector)) {
+            this.push(...Array.from(selector));
+        }
+    }
+    /**
+     * * 🇬🇧: Custom serializer for JSON.stringify. Prevents circular references and huge outputs by returning a simplified preview.
+     * * 🇩🇪: Benutzerdefinierte Serialisierung für JSON.stringify. Verhindert Zirkelbezüge und riesige Ausgaben durch Rückgabe einer vereinfachten Vorschau.
+     * @returns
+     * * 🇬🇧: A simplified object representation for debugging.
+     * * 🇩🇪: Eine vereinfachte Objektrepräsentation für das Debugging.
+     */
+    toJSON() {
+        return {
+            meta: 'jBase Wrapper',
+            query: this.selectorSource,
+            count: this.length,
+            preview: this.slice(0, 10).map(el => {
+                if (el instanceof Element)
+                    return el.tagName.toLowerCase();
+                return typeof el;
+            })
+        };
+    }
+}
+exports.jBase = jBase;
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAIH;;;GAGG;AACH,MAAa,KAAM,SAAQ,KAAmB;IAG1C;;;;;;OAMG;IACH,YAAY,QAAqB;QAC7B,KAAK,EAAE,CAAC;QAVL,mBAAc,GAAW,EAAE,CAAC;QAY/B,IAAI,CAAC,cAAc,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAErF,IAAI,CAAC,QAAQ;YACT,OAAO;QAEX,4CAA4C;QAC5C,IAAI,QAAQ,YAAY,WAAW,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YACjH,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,4CAA4C;aACvC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEhC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnD,gBAAgB;gBAChB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC9C,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC;gBAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACJ,eAAe;gBACf,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClE,CAAC;QACL,CAAC;QACD,mCAAmC;aAC9B,IAAI,QAAQ,YAAY,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,QAAmC,CAAC,CAAC,CAAC;QAClE,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACF,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,IAAI,CAAC,cAAc;YAC1B,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAChC,IAAI,EAAE,YAAY,OAAO;oBACrB,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACpC,OAAO,OAAO,EAAE,CAAC;YACrB,CAAC,CAAC;SACL,CAAC;IACN,CAAC;CACJ;AA7DD,sBA6DC"}