aprog 2.0.6 → 2.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aprog",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "description": "Допоміжна JavaScript-бібліотека для проєктів",
   "main": "index.js",
   "exports": {
@@ -10,7 +10,10 @@
     }
   },
   "scripts": {
-    "test": "jest"
+    "test": "jest",
+    "postinstall": "node ./publish.js",
+    "publish-files": "node ./publish.js",
+    "publish-force": "node ./publish.js --force"
   },
   "repository": {
     "type": "git",

package/src/constructs/ButtonConstructor.js

@@ -0,0 +1,45 @@
+import {button, GUID} from "aprog";
+
+/**
+ * AprogJS Constructor
+ * --- ButtonSearchConstructor ---
+ * Copyright (c) 2025 AlexProger.
+ */
+export const ButtonConstructor = {
+    /**
+     * create HTMLElement
+     */
+    constructor() {
+        const instance = Object.create(this);
+        instance.class = GUID();
+        return instance;
+    },
+
+    /**
+     * set HTMLElement
+     */
+    element({
+        id = undefined,
+        className = "",
+        style = {},
+        type = undefined,
+        text = "",
+        callback = () => {},
+    } = {}) {
+        return this.is = button({
+            id: id || GUID(),
+            class: `${this.class} btn ${className} disabled`,
+            style: style,
+            ...(type && {type: type}),
+            value: text,
+            onClick: callback
+        });
+    },
+
+    /**
+     * get target [HTMLElement]
+     */
+    get target() {
+        return this?.is;
+    }
+};

package/src/constructs/InputConstructor.js

@@ -0,0 +1,50 @@
+import {GUID, input} from "aprog";
+
+/**
+ * AprogJS Constructor
+ * --- InputConstructor ---
+ * Copyright (c) 2025 AlexProger.
+ */
+export const InputConstructor = {
+    /**
+     * create HTMLElement
+     */
+    constructor() {
+        const instance = Object.create(this);
+        instance.class = GUID();
+        return instance;
+    },
+
+    /**
+     * set HTMLElement
+     */
+    element({
+        id = undefined,
+        className = "",
+        style = {},
+        type = undefined,
+        focus = false,
+        placeholder = undefined,
+        value = undefined,
+        nameCallback = "onInput",
+        callback = () => {},
+    } = {}) {
+        return this.is = input({
+            id: id || GUID(),
+            class: `${this.class} input ${className}`,
+            style: style,
+            ...(type && {type: type}),
+            focus: focus,
+            ...(placeholder && {placeholder: placeholder}),
+            ...(value && {value: value}),
+            [nameCallback]: callback,
+        });
+    },
+
+    /**
+     * get target [HTMLElement]
+     */
+    get target() {
+        return this?.is;
+    }
+};

package/src/publish.js

@@ -0,0 +1,48 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const force = process.argv.includes('--force');
+
+/**
+ * Копіює файл, якщо його ще нема, або перезаписує, якщо --force
+ */
+function copyFile(from, to) {
+    fs.mkdirSync(path.dirname(to), { recursive: true });
+
+    if (!fs.existsSync(to) || force) {
+        fs.copyFileSync(from, to);
+        console.log(`✅ Копійовано: ${from} → ${to}`);
+    } else {
+        console.log(`ℹ️ Пропущено (вже існує): ${to}`);
+    }
+}
+
+/**
+ * Копіює всі .js файли з src/constructs у resources/js/components/constructs
+ */
+function copyConstructs() {
+    const srcDir = path.resolve(__dirname, 'src/constructs');
+    const destDir = path.resolve(process.cwd(), 'resources/js/components/constructs');
+
+    if (!fs.existsSync(srcDir)) {
+        console.error(`❌ Не знайдено директорії: ${srcDir}`);
+        process.exit(1);
+    }
+
+    const files = fs.readdirSync(srcDir);
+
+    files.forEach(file => {
+        const from = path.join(srcDir, file);
+        const to = path.join(destDir, file);
+
+        if (fs.statSync(from).isFile() && path.extname(from) === '.js') {
+            copyFile(from, to);
+        }
+    });
+}
+
+console.log('📦 Починаю копіювання файлів з Aprog...');
+copyConstructs();
+console.log('🏁 Готово.');

package/src/redirect.js

@@ -28,23 +28,25 @@ export const validatePassword = (password) => {
 /**
  * --- Функція для відкладеного запуску скрипта ---
  * ідентична `setTimeout`, але використовує секунди
- * @param handler
- * @param seconds
- * @param args
+ * @param {TimerHandler} handler
+ * @param {int|float} seconds
+ * @param {any[]} args
+ * @return {number}
  */
 export const delay = (handler, seconds, args = []) => {
     seconds *= 1000;
-    setTimeout(handler, seconds, ...args);
+    return setTimeout(handler, seconds, ...args);
 };
 
 /**
  * --- Функція для циклічності скрипта ---
  * ідентична `setInterval`, але використовує секунди
- * @param handler
- * @param seconds
- * @param args
+ * @param {TimerHandler} handler
+ * @param {int|float} seconds
+ * @param {any[]} args
+ * @return {number}
  */
 export const cycle = (handler, seconds, args = []) => {
     seconds *= 1000;
-    setInterval(handler, seconds, ...args)
+    return setInterval(handler, seconds, ...args)
 };