tiny-essentials 1.26.0 → 1.26.2

package/README.md

@@ -94,7 +94,7 @@ Feel free to fork, contribute, and create pull requests for improvements! Whethe
 
 ## 📝 License
 
-This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the LGPL-3.0 License - see the [LICENSE](LICENSE) file for details.
 
 ### 💡 Credits
 

package/TinyFork.mjs

@@ -46,17 +46,45 @@ const PATHS = {
  * @property {string[]} functionsToExtract - The specific functions to pull via Babel.
  */
 function parseTarget(rawTarget) {
+  /**
+   * Extracted version from the target string.
+   * @type {number|null}
+   */
   let targetVersion = null;
+
+  /**
+   * The target string without the version prefix.
+   * @type {string}
+   */
   let cleanTarget = rawTarget;
 
+  /**
+   * Regex match result for versioning.
+   * @type {RegExpMatchArray|null}
+   */
   const versionMatch = rawTarget.match(/^v(\d+)\//);
+
   if (versionMatch) {
     targetVersion = parseInt(versionMatch[1], 10);
     cleanTarget = rawTarget.replace(versionMatch[0], '');
   }
 
+  /**
+   * Indicates if specific functions are requested.
+   * @type {boolean}
+   */
   const hasFunctions = cleanTarget.includes(',');
+
+  /**
+   * List of specific function names to extract.
+   * @type {string[]}
+   */
   let functionsToExtract = [];
+
+  /**
+   * The base file path to search for.
+   * @type {string}
+   */
   let basePath = cleanTarget;
 
   if (hasFunctions) {
@@ -83,8 +111,22 @@ async function resolveSourceFile(targetVersion, basePath) {
     throw new Error('Forbidden extraction: Cannot export files from the build directory.');
   }
 
+  /**
+   * Supported file extensions.
+   * @type {string[]}
+   */
   const extensions = ['.mjs', '.js'];
+
+  /**
+   * The starting version for the resolution search.
+   * @type {number}
+   */
   const startVersion = targetVersion || LATEST_VERSION;
+
+  /**
+   * The ending version for the resolution search limit.
+   * @type {number}
+   */
   const endVersion = targetVersion ? targetVersion : 1;
 
   for (let v = startVersion; v >= endVersion; v--) {
@@ -115,6 +157,37 @@ async function resolveSourceFile(targetVersion, basePath) {
   throw new Error(`Module not found: ${basePath}`);
 }
 
+/**
+ * Copies the LICENSE file from the project root to the destination vendor directory.
+ *
+ * @param {string} destDir - The final vendor output directory.
+ * @returns {Promise<void>} Resolves when the file is copied (or skipped if missing).
+ */
+async function copyLicense(destDir) {
+  /**
+   * Absolute path to the original LICENSE file.
+   * @type {string}
+   */
+  const licenseSrc = path.join(PATHS.cliRoot, 'LICENSE');
+
+  /**
+   * Absolute path to the destination LICENSE file.
+   * @type {string}
+   */
+  const licenseDest = path.join(destDir, 'LICENSE');
+
+  try {
+    if (existsSync(licenseSrc)) {
+      await fs.copyFile(licenseSrc, licenseDest);
+      console.log('> Copied: LICENSE');
+    } else {
+      console.warn('> Warning: LICENSE file not found in the root directory.');
+    }
+  } catch (error) {
+    console.error(`> Error copying LICENSE: ${error.message}`);
+  }
+}
+
 /**
  * Advanced Multi-File Dependency Extractor.
  * Parses files, traces dependencies, and extracts everything mirroring the original structure.
@@ -569,14 +642,25 @@ class MultiFileExtractor {
 async function runCLI() {
   const args = process.argv.slice(2);
 
+  /**
+   * The explicit output directory argument if passed.
+   * @type {string|undefined}
+   */
   const outDirArg = args.find((a) => a.startsWith('--out-dir='));
+
+  /**
+   * The formatted custom output directory.
+   * @type {string|null}
+   */
   const customOutDir = outDirArg ? outDirArg.split('=')[1] : null;
 
   // Filter out flags to get the raw target strings
   const rawTargets = args.filter((a) => !a.startsWith('--'));
 
   if (rawTargets.length === 0) {
-    console.error('Usage: npx tiny-essentials-fork [--out-dir=custom/path] <target1> [target2] ...');
+    console.error(
+      'Usage: npx tiny-essentials-fork [--out-dir=custom/path] <target1> [target2] ...',
+    );
     console.error('Example: npx tiny-essentials-fork v1/basics/example/func1 v1/lib/TinyHtml');
     process.exit(1);
   }
@@ -598,6 +682,9 @@ async function runCLI() {
 
     console.log(`Starting extraction to: ${finalVendorDir}\n`);
     await extractor.processQueue();
+
+    // Copy the license file explicitly at the very end of processing
+    await copyLicense(finalVendorDir);
   } catch (error) {
     console.error('\nError extracting modules:');
     console.error(error.message);

package/changelog/1/26/2.md

@@ -0,0 +1,10 @@
+## ✨ New Features & Additions
+
+### ⚙️ **TinyClassManager** (`libs/TinyClassManager.mjs`)
+
+A lightweight, immutable manager designed to linearly compose a base class with multiple modular plugins (mixins). It acts as a safe pipeline for class extension.
+
+* **🔒 Immutable Chain State:** Each `.use()` call consumes the previous manager instance and returns a new one. This ensures predictable state transitions and prevents unwanted side effects or accidental reuses of an old chain.
+* **🧩 Smart Dependency Verification:** Plugins can define a `dependencies` array. The manager automatically verifies that all required modules are installed *before* applying the new plugin. If a dependency is missing, it throws a clear, descriptive error.
+* **🛑 Duplicate Conflict Protection:** Accidentally applying the same plugin twice? The manager actively prevents this by tracking applied plugins and throwing an error if a conflict is detected.
+* **🛠️ Clean Build Pipeline:** The `.build()` method finalizes the composition, locking the manager and returning the fully compiled class, ready to be instantiated.

package/dist/v1/TinyClassManager.min.js

@@ -0,0 +1 @@
+(()=>{"use strict";var e={d:(s,n)=>{for(var a in n)e.o(n,a)&&!e.o(s,a)&&Object.defineProperty(s,a,{enumerable:!0,get:n[a]})},o:(e,s)=>Object.prototype.hasOwnProperty.call(e,s)},s={};e.d(s,{TinyClassManager:()=>a});class n{#e=new Set;get appliedPlugins(){return[...this.#e]}get size(){return this.#e.size+1}#s;get currentClass(){return this.#s}#n=!1;get used(){return this.#n}constructor(e){this.#s=e}use(e){if(this.#n)throw new Error("[TinyClassManager] Cannot reuse a consumed manager instance.");if(this.#e.has(e.name))throw new Error(`[TinyClassManager] Plugin conflict: "${e.name}" is already installed.`);const s=e.dependencies||[];for(const n of s)if(!this.#e.has(n))throw new Error(`[TinyClassManager] Missing Dependency: "${e.name}" requires "${n}" to be installed first.`);const a=new n(e.apply(this.#s));return this.#e.forEach(e=>a.#e.add(e)),a.#e.add(e.name),this.#n=!0,this.#e.clear(),a}build(){if(this.#n)throw new Error("[TinyClassManager] Cannot build from an already finalized manager.");return this.#n=!0,this.#e.clear(),this.#s}}const a=n;window.TinyClassManager=s.TinyClassManager})();