archy-framework 1.0.1

package/.github/workflows/main.yml

@@ -0,0 +1,47 @@
+name: Fluxur Commit Notifier
+
+on:
+  push:
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Send clean message to Fluxer
+      env:
+        WEBHOOK_URL: ${{ secrets.FLUXUR_WEBHOOK }}
+        REPO: ${{ github.repository }}
+        ACTOR: ${{ github.actor }}
+        COMMIT_MSG: ${{ github.event.head_commit.message }}
+        COMMIT_URL: ${{ github.event.head_commit.url }}
+      run: |
+        curl -X POST "$WEBHOOK_URL" \
+          -H "Content-Type: application/json" \
+          -d "{
+            \"content\": \"🚀 New commit pushed\nRepo: $REPO\nAuthor: $ACTOR\nCommit: $COMMIT_MSG\nURL: $COMMIT_URL\",
+            \"username\": \"GitHub Bot\"
+          }"name: Fluxur Commit Notifier
+
+on:
+  push:
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Send clean message to Fluxer
+      env:
+        WEBHOOK_URL: ${{ secrets.FLUXUR_WEBHOOK }}
+        REPO: ${{ github.repository }}
+        ACTOR: ${{ github.actor }}
+        COMMIT_MSG: ${{ github.event.head_commit.message }}
+        COMMIT_URL: ${{ github.event.head_commit.url }}
+      run: |
+        curl -X POST "$WEBHOOK_URL" \
+          -H "Content-Type: application/json" \
+          -d "{
+            \"content\": \"🚀 New commit pushed\nRepo: $REPO\nAuthor: $ACTOR\nCommit: $COMMIT_MSG\nURL: $COMMIT_URL\",
+            \"username\": \"GitHub Bot\"
+          }"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 C3real
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+<p align="center">
+  <img src="public/assets/logo.png" alt="Logo" width="200">
+</p>
+
+![Status](https://img.shields.io/badge/STATUS-Good-brightgreen)
+![NPM](https://img.shields.io/badge/VERSION-1.0.0-blue)
+![License](https://img.shields.io/badge/LICENSE-MIT-green)
+
+# Archy.JS
+Archy.JS is a utility framework mainly focused on improving understandability, and readability, as well as giving it a more professional look. Some features may be irrelevant, but still provide important functions.
+
+## What happened to Vector.js?
+There's already a framework named Vector.js.
+
+## Example
+
+```javascript
+import { app } from "../src/index.js";
+import "../src/api/archy.js"
+
+app.getDomID("test").innerText = "Hello World!";
+````
+
+## Developer Notice
+To test out a feature via http server, run:
+```bash 
+archy start
+```
+
+

package/bin/archy.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+import { exec, spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+
+const args = process.argv.slice(2);
+const latest_build_version = "1.0.1"
+
+const command = args[0];
+const flag = args[1];
+
+if (command === "-start") {
+
+    console.log("[Archy] Starting dev server on port 8000...");
+
+    const server = spawn(
+        "python3",
+        ["-m", "http.server", "8000"],
+        {
+            stdio: "inherit"
+        }
+    );
+
+    server.on("close", (code) => {
+        console.log(`[Archy] Server exited with code ${code}`);
+    });
+
+}
+
+if (command  == "-version") {
+    console.log(`[Archy] version ${latest_build_version}`);
+}
+
+if (command == "-plugins") {
+    try {
+        const pluginsDir = path.join(process.cwd(), "plugins");
+
+        if (!fs.existsSync(pluginsDir)) {
+            console.log('[Archy] No plugins directory found at ./plugins/');
+        } else {
+            const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
+            const pluginNames = entries
+                .filter(e => e.isDirectory() || e.isFile())
+                .map(e => e.name);
+
+            if (pluginNames.length === 0) {
+                console.log('[Archy] No plugins found in ./plugins/');
+            } else {
+                console.log('[Archy] Plugins:');
+                pluginNames.forEach(n => console.log(` - ${n}`));
+            }
+        }
+    } catch (err) {
+        console.error('[Archy] Error reading plugins:', err.message || err);
+    }
+}
+
+if (command == "help") {
+    console.log("[Archy]: archy -start to start a server");
+    console.log("[Archy]: archy -version to see current version");
+    console.log("[Archy]: archy -plugins to see all plugins in ./plugins/");
+    console.log("[Archy]: archy -commit to commit changes to git");
+}
+
+if (command == "-commit") {
+    spawn("./scripts/commit.sh", [], { stdio: "inherit" });
+}

package/contributors.txt

@@ -0,0 +1,9 @@
+You may introduce your self here by displaying your name or username, email, and country/state.
+Suggest using this format below for a clean and organized display:
+
+name/userame - country, state
+username@gmail.com
+
+
+crashcourse14 - Texas, The States.
+haydyncm@gmail.com

package/examples/example1.js

@@ -0,0 +1,10 @@
+import { archy } from "../src/index.js";
+import "../lib/lib.js"
+
+archy.getDomID("title").innerText = "Vector.JS";
+
+archy.setClassList({
+    id: "title",
+    classList: "important"
+})
+

package/help.md

@@ -0,0 +1,52 @@
+# HELP
+Use this as a reference if you want to learn, or simply forget how to do something.
+
+## DOM API
+```javascript
+
+const a = app.getDomID(id);
+const b = app.getDomsID(id);
+const c = app.getDomClass(class);
+const d = app.getDomsClass(class);
+const e = app.getDomsTag(tag);
+
+app.addClassList({
+    id: "id",
+    classList: "class"
+});
+
+app.rmvClassList({
+    id: "id"
+    classList: "class"
+});
+
+```
+
+## SCAFFOLDING
+
+```javascript
+
+app.const("Human", {
+    name: "John",
+    age: "30" 
+    //add more things about this constant
+});
+
+app.function("name", (name) => {
+    //function
+});
+ 
+app.function.name(arg);  //if you want to use the app.const constant, use: ${app.constant.name.argument}
+
+```
+
+## MATH
+
+```javascript
+
+const f = app.ceil(number);
+const g = app.round(number);
+const h = app.trunc(number); 
+const i = app.floor(number);
+
+```

package/lib/lib.js

@@ -0,0 +1,16 @@
+export * from "../src/api/getDomClass.js"
+export * from "../src/api/getDomsClass.js"
+export * from "../src/api/getDomID.js"
+export * from "../src/api/getDomsID.js"
+export * from "../src/api/createDom.js"
+export * from "../src/api/getDomsTag.js"
+export * from "../src/api/setClassList.js"
+export * from "../src/api/rmvClassList.js"
+export * from "../src/window/openWindow.js"
+export * from "../src/math/round.js"
+export * from "../src/math/floor.js"
+export * from "../src/math/ceil.js"
+export * from "../src/math/trunc.js"
+export * from "../src/scaffold/function.js"
+export * from "../src/scaffold/constant.js"
+

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "archy-framework",
+  "version": "1.0.1",
+  "description": "A lightweight JavaScript framework for DOM and networking utilities.",
+  "main": "src/index.js",
+  "type": "module",
+  "scripts": {
+    "start": "archy -start",
+    "version": "archy -version",
+    "build": "archy -start",
+    "plugins": "archy -plugins",
+    "commit": "archy -commit"
+  },
+  "bin": {
+    "archy": "./bin/archy.js"
+  },
+  "keywords": [
+    "framework",
+    "javascript",
+    "dom",
+    "networking",
+    "archy"
+  ],
+  "author": "C3realCodes",
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {}
+}

package/plugins/example.js

@@ -0,0 +1,11 @@
+
+//NEEDED or else it WON'T WORK.
+import { app } from "../src/index.js";
+
+export const AUTHOR = "C3real";
+export const DESCRIPTION = "This is an example plugin for Archy.JS. It adds a simple alert function to the app.";
+
+//Start off by defining "app" then the function as in app.function.
+app.alert = function(message) {
+    alert(message);
+}

package/plugins/plugin.md

@@ -0,0 +1,2 @@
+## How to use a plugin
+Add the file(s) to this directory, then go to your main file, and add a import statment from the plugin files you're using.

package/public/index.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Vector Test</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+
+  <h1 id="title">Hello World</h1>
+  <h1 id="title2">Hello World</h1>
+  <h1 id="title3">Hello World</h1>
+
+  <script type="module" src="script.js"></script>
+
+</body>
+</html>

package/public/script.js

@@ -0,0 +1,33 @@
+import { app } from "../src/index.js";
+import "../lib/lib.js"
+
+// This is from the plugin
+import "../plugins/example.js"
+app.alert("hello") //Should probably make this native to the app, but for now it's just an example of how to use plugins.
+
+app.getDomID("title").innerText = "Archy.JS";
+
+app.setClassList({
+    id: "title",
+    classList: "important"
+})
+
+app.const("Human", {
+    name: "John",
+    age: "30"
+    //more things about human
+});
+
+app.function("greet", (name) => {
+    alert(`Hello, ${name}!`);
+});
+
+//app.function.greet(app.const.Human.name); 
+
+
+
+
+
+
+
+

package/public/style.css

@@ -0,0 +1,4 @@
+.important {
+    font-size: 40px;
+    color: blue;
+}

package/scripts/commit.sh

@@ -0,0 +1,10 @@
+author=$(git log -1 --pretty=%an)
+
+echo "Commit Message:"
+read COMMIT_MSG
+
+git init
+git add .
+git commit -m "[$author]: $COMMIT_MSG"
+
+git push

package/src/api/createDom.js

@@ -0,0 +1,22 @@
+import { app } from "../index.js"
+
+app.createDom = function({id, className }) {
+
+    const element = document.createElement("div");
+
+    if (id) {
+        element.id = id;
+    } else {
+        throw new Error("[createDom] [VDAPI] createDom return an ID that is null!");
+    }
+
+    if (className) {
+        element.className = className;
+    } else {
+        throw new Error("[createDom] [VDAPI] createDom return a class name that is null!");
+    }
+
+    document.body.appendChild(element);
+
+    return element;
+};

package/src/api/getDomClass.js

@@ -0,0 +1,11 @@
+import { app } from "../index.js"
+
+app.getDomClass = function(className) {
+    const element = document.getElementByClassName(className);
+
+    if (!element) {
+        throw new Error(`[getDomClass] [VDAPI] archy.getDomClass returned a null class!`);
+    }
+    
+    return element;
+}

package/src/api/getDomID.js

@@ -0,0 +1,11 @@
+import { app } from "../index.js"
+
+app.getDomID = function(id) {
+    const element = document.getElementById(id);
+
+    if (!element) {
+        throw new Error(`[getDomID] [VDAPI] archy.getDomID returned null`);   
+    }
+
+    return element;
+}

package/src/api/getDomsClass.js

@@ -0,0 +1,11 @@
+import { app } from "../index.js"
+
+app.getDomClass = function(className) {
+    const element = document.getElementsByClassName(className);
+
+    if (!element) {
+        throw new Error(`[getDomClass] [VDAPI] archy.getDomsClass returned (a) null class(es)!`);
+    }
+    
+    return element;
+}

package/src/api/getDomsID.js

@@ -0,0 +1,11 @@
+import { app } from "../index.js"
+
+app.getDomID = function(id) {
+    const element = document.getElementById(id);
+
+    if (!element) {
+        throw new Error(`[getDomsID] [VDAPI] archy.getDomsID returned (a) null id(s)`);   
+    }
+
+    return element;
+}

package/src/api/getDomsTag.js

@@ -0,0 +1,11 @@
+import { app } from "../index.js"
+
+app.getDomTags = function(tagNames) {
+    const element = document.getElementsByTagName(tagNames);
+
+    if (!element) {
+        throw new Error(`[getDomsTag] [VDAPI] archy.getDomsTag returned (a) null tag(s)!`)
+    }
+
+    return element;
+}

package/src/api/rmvClassList.js

@@ -0,0 +1,13 @@
+import { app } from "../index.js"
+
+app.rmvClassList = function({id, classListName}) {
+    const element = document.getElementById(id);
+
+    if (!id) {
+        throw new Error(`[setClassList] [VAPI] archy.setClassList returned an ID that is null!`);
+    }
+
+    element.classList.remove(classListName);
+
+    return element;
+}

package/src/api/setClassList.js

@@ -0,0 +1,13 @@
+import { app } from "../index.js"
+
+app.setClassList = function({id, classList}) {
+    const element = document.getElementById(id);
+
+    if (!id) {
+        throw new Error(`[setClassList] [VAPI] archy.setClassList returned an ID that is null!`);
+    }
+
+    element.classList.add(classList);
+
+    return element;
+}

package/src/index.js

@@ -0,0 +1,2 @@
+export const app = {};
+export const archy = {};

package/src/math/ceil.js

@@ -0,0 +1,9 @@
+import { archy } from "../index.js"
+
+archy.ceil = function(number) {
+    if (typeof number !== "number") {
+        throw new Error(`[ceil] [VMATH] archy.ceil expected a number!`);
+    }
+
+    return Math.ceil(number);
+}

package/src/math/floor.js

@@ -0,0 +1,10 @@
+import { archy } from "../index.js"
+
+archy.floor = function(number) {
+
+    if (typeof number !== "number") {
+        throw new Error(`[floor] [VMATH] expected a number in archy.floor() but it returned null.`)
+    }
+
+    return Math.floor(number);
+} 

package/src/math/round.js

@@ -0,0 +1,10 @@
+import { archy } from "../index.js"
+
+archy.round = function(number) {
+
+    if (typeof number !== "number") {
+        throw new Error(`[round] [VMATH] expected a number in archy.round() but it returned null.`)
+    }
+
+    return Math.round(number);
+}

package/src/math/trunc.js

@@ -0,0 +1,10 @@
+import { archy } from "../index.js"
+
+archy.trunc = function(number) {
+
+    if (typeof number !== "number") {
+        throw new Error(`[trunc] [VMATH] expected a number in archy.trunc() but it returned null.`)
+    }
+
+    return Math.trunc(number);
+}

package/src/roadmap/design.txt

@@ -0,0 +1,3 @@
+app.function hello(argument) {
+    
+} 

package/src/scaffold/constant.js

@@ -0,0 +1,14 @@
+import { app } from "../index.js";
+
+app.const = function(name, value) {
+    if (app.const[name]) {
+        throw new Error(`[const] [VDAPI] app.const returned a duplicate constant!`);
+    }
+
+    Object.defineProperty(app.const, name, {
+        value: value,
+        writable: false,
+        configurable: false
+    });
+}
+

package/src/scaffold/function.js

@@ -0,0 +1,14 @@
+import { app } from "../index.js";
+
+app.function = function(name, fn) {
+    if (app.function[name]) {
+        throw new Error(`[function] [Archy] app.function returned a duplicate function!`);
+    }
+
+    Object.defineProperty(app.function, name, {
+        value: fn,
+        writable: false,
+        configurable: false
+    });
+}
+

package/src/window/openWindow.js

@@ -0,0 +1,12 @@
+import { app } from  "../index.js"
+
+app.openWindow = function({url, args}) {
+
+    if (!args) {
+        return;
+    }
+
+    return window.open(url, "_blank", args);
+}
+
+