asajs 4.0.0-indev-3 → 4.0.0-indev-4

package/README.md

@@ -1,3 +1,57 @@
-AsaJS Logo made by [Kammasy](https://www.youtube.com/channel/UCrmjDWdM8-ZSeekzLeCnftg) a.k.a **[E.G.G](https://www.youtube.com/channel/UCrmjDWdM8-ZSeekzLeCnftg)**
+<div align="center">
+<img src="./resources/logo.png" />
 
-![image](/resources/logo.png)
+<h2 align="center">
+    <a href="https://asajs.asakiyuki.com/">AsaJS</a> - The <a href="https://www.minecraft.net/en-us">Minecraft: Bedrock Edition</a> JSON-UI Framework
+</h2>
+    
+[![asajs version](https://img.shields.io/npm/v/asajs.svg?style=for-the-badge&labelColor=000000)](https://www.npmjs.com/package/asajs)
+[![asajs license](https://img.shields.io/npm/l/asajs.svg?style=for-the-badge&labelColor=000000)](https://github.com/AsakiYuki/AsaJS/blob/main/README.md)
+[![asajs downloads](https://img.shields.io/npm/dm/asajs.svg?style=for-the-badge&labelColor=000000)](https://www.npmjs.com/package/asajs)
+</div>
+
+**AsaJS** is a NodeJS library designed to empower developers to create **JSON-UI** packages for Minecraft: Bedrock Edition using **JavaScript** or **TypeScript**.
+
+Say goodbye to the tedious and repetitive nature of manual JSON editing. AsaJS streamlines your workflow by bringing the programmatic flexibility to Minecraft UI development.
+
+## 🛠 Installation
+
+To use AsaJS, ensure you have **[Node.js](https://nodejs.org/en)** installed on your system.
+
+**Latest stable version:**
+
+```bash
+npm install asajs
+```
+
+**For our nightly builds:**
+
+```
+npm install asajs@indev
+```
+
+## 📖 "Hello World!" Example
+
+Creating a custom UI with AsaJS is straightforward. Here is how you can insert a custom label onto the Minecraft Start Screen:
+
+```javascript
+import { Anchor, Label, Modify } from "asajs"
+
+const label = Label({
+	text: "Hello World from my Custom UI!",
+	shadow: true,
+	anchor: Anchor.TOP_MIDDLE,
+	offset: [0, 10],
+})
+
+// This code injects the label into the top of the start screen
+Modify("start", "start_screen_content").insertChild(label)
+```
+
+## 📚 Documentation
+
+Detailed guides and API references are available at: 👉 https://asajs.asakiyuki.com/
+
+## 🤝 Contributing
+
+Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

package/config.d.ts

@@ -3,7 +3,10 @@ import { Variable } from "./src/types/properties/value.ts"
 export interface Config {
 	compiler?: {
 		enabled?: boolean
-		linked?: boolean
+		autoImport?: boolean
+		importToPreview?: boolean
+		autoEnable?: boolean
+		gdkUserId?: string
 	}
 	packinfo?: {
 		name?: string

package/dist/js/compilers/Configuration.js

@@ -8,8 +8,8 @@ if (!fs.existsSync(".gitignore")) {
 }
 export const config = require(path.resolve(process.cwd(), "asajs.config.cjs")).config;
 export let isBuildMode = config.compiler?.enabled ?? false;
-export let isLinkMode = config.compiler?.linked ?? false;
-export let unLinked = !(config.compiler?.linked ?? true);
+export let isLinkMode = config.compiler?.autoImport ?? false;
+export let unLinked = !(config.compiler?.autoImport ?? true);
 for (const arg of process.argv) {
     if (arg === "--build")
         isBuildMode = true;

package/dist/js/compilers/Memory.js

@@ -20,7 +20,7 @@ export class Memory extends Class {
     }
     static build() {
         const data = new Map();
-        Memory.files.entries().forEach(([path, { elements, namespace }]) => {
+        Array.from(Memory.files.entries()).forEach(([path, { elements, namespace }]) => {
             const record = {};
             elements.forEach(element => (record[element.name] = element));
             data.set(path, {

package/dist/js/compilers/PreCompile.js

@@ -6,4 +6,15 @@ Map.prototype.toJSON = function () {
 Array.prototype.lastItem = function () {
     return this[this.length - 1];
 };
-export {};
+const now = performance.now();
+function TypeHighlight(type) {
+    switch (type) {
+        case "INFO":
+            return `\x1b[32mINFO\x1b[0m`;
+        default:
+            return type;
+    }
+}
+export function Log(type, message) {
+    console.log(`\x1b[90m[${(performance.now() - now).toFixed(2)}ms]\x1b[0m`, `[${TypeHighlight(type)}]`, message, "\x1b[0m");
+}

package/dist/js/compilers/ui/builder.js

@@ -1,9 +1,12 @@
 import { config, isBuildMode, isLinkMode, unLinked } from "../Configuration.js";
 import { Memory } from "../Memory.js";
-import { createBuildFolder, linkToGame, unlink } from "./linker.js";
-import { genManifest } from "./manifest.js";
+import { createBuildFolder, gamePath, getBuildFolderName, linkToGame, unlink } from "./linker.js";
+import { genManifest, version } from "./manifest.js";
 import fs from "fs/promises";
 import { BuildCache } from "./buildcache.js";
+import { disableRSP, enableRSP } from "./installer.js";
+import { Log } from "../PreCompile.js";
+import path from "path";
 async function buildUI() {
     const build = Memory.build();
     build.set("ui/_ui_defs.json", {
@@ -16,20 +19,28 @@ async function buildUI() {
         await fs
             .stat(outFile.split(/\\|\//g).slice(0, -1).join("/"))
             .catch(async () => await fs.mkdir(outFile.split(/\\|\//g).slice(0, -1).join("/"), { recursive: true }));
-        await fs.writeFile(outFile, JSON.stringify(Object.fromEntries(Object.entries(value).map(([key, value]) => {
+        await fs
+            .writeFile(outFile, JSON.stringify(Object.fromEntries(Object.entries(value).map(([key, value]) => {
             const extend = value.extend;
             return [extend ? key + String(extend) : key, value];
-        }))), "utf-8");
+        }))), "utf-8")
+            .then(() => Log("INFO", `${outFile} with ${Object.keys(value).length} elements created!`));
         build.delete(file);
         return file;
     }));
     await Promise.all([
-        fs.writeFile("build/manifest.json", await genManifest(), "utf-8"),
-        fs.writeFile("build/.gitignore", [...out, "manifest.json"].join("\n"), "utf-8"),
-        BuildCache.set("build-files", [...out, "manifest.json"]),
+        fs
+            .writeFile("build/manifest.json", await genManifest(), "utf-8")
+            .then(() => Log("INFO", "build/manifest.json created!")),
+        fs
+            .writeFile("build/.gitignore", [...out, "manifest.json"].join("\n"), "utf-8")
+            .then(() => Log("INFO", "build/.gitignore created!")),
+        BuildCache.set("build-files", [...out, "manifest.json"]).then(() => Log("INFO", "build-files set!")),
+        BuildCache.set("version", version).then(() => Log("INFO", "version set!")),
         fs
             .stat("build/pack_icon.png")
-            .catch(() => fs.copyFile("node_modules/asajs/resources/pack_icon.png", "build/pack_icon.png")),
+            .catch(() => fs.copyFile("node_modules/asajs/resources/pack_icon.png", "build/pack_icon.png"))
+            .then(() => Log("INFO", "build/pack_icon.png copied!")),
     ]);
     return out.length;
 }
@@ -41,6 +52,19 @@ if (isBuildMode) {
             await buildUI();
             if (isLinkMode)
                 await linkToGame();
+            if (config.compiler?.autoEnable)
+                await enableRSP();
+            else
+                await disableRSP();
+            Log("INFO", "Build completed!");
+            console.log("========================= PACK INFO =========================");
+            console.log("Name:", `\x1b[32m${config.packinfo?.name || "MyPack"}\x1b[0m`);
+            console.log("Description:", `\x1b[32m${config.packinfo?.description || "Create your Minecraft JSON-UI resource packs using JavaScript."}\x1b[0m`);
+            console.log("Version:", config.packinfo?.version || [4, 0, 0]);
+            console.log("UUID:", await BuildCache.get("uuid"));
+            if (gamePath)
+                console.log("Install Path:", `\x1b[32m"${path.join(gamePath, await getBuildFolderName())}"\x1b[0m`);
+            console.log("=============================================================");
         }
         first = false;
     });

package/dist/js/compilers/ui/installer.js

@@ -1,15 +1,150 @@
 import os from "os";
 import path from "path";
+import fs from "fs";
+import fsp from "fs/promises";
+import { config } from "../Configuration.js";
+import { BuildCache } from "./buildcache.js";
+import { version } from "./manifest.js";
+import { Log } from "../PreCompile.js";
+export const pathinfo = {
+    os: os.platform(),
+    isGdk: false,
+    gamepath: null,
+};
+function getGlobalResourcePackFile(gamepath) {
+    return path.join(gamepath, "minecraftpe/global_resource_packs.json");
+}
+async function readGlobalRspFile(filepath) {
+    try {
+        if (await fsp.stat(filepath)) {
+            return JSON.parse(await fsp.readFile(filepath, "utf-8"));
+        }
+    }
+    catch (error) {
+        return null;
+    }
+}
+async function writeGlobalRspFile(filepath, data) {
+    try {
+        await fsp.writeFile(filepath, JSON.stringify(data), "utf-8");
+    }
+    catch (error) {
+        return null;
+    }
+}
+export async function enable(uuid, version, filepath) {
+    try {
+        const globalRsp = await readGlobalRspFile(filepath);
+        if (!globalRsp)
+            return null;
+        const index = globalRsp.findIndex(data => data.pack_id === uuid);
+        if (index === -1) {
+            globalRsp.push({ pack_id: uuid, version });
+            await writeGlobalRspFile(filepath, globalRsp);
+            return true;
+        }
+        else if (globalRsp[index].version.join(".") !== version.join(".")) {
+            globalRsp[index].version = version;
+            await writeGlobalRspFile(filepath, globalRsp);
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        return null;
+    }
+}
+export async function disable(uuid, filepath) {
+    try {
+        let globalRsp = await readGlobalRspFile(filepath);
+        if (!globalRsp)
+            return null;
+        let isWrite = false;
+        globalRsp = globalRsp.filter(data => {
+            if (data.pack_id === uuid)
+                isWrite = true;
+            return data.pack_id !== uuid;
+        });
+        if (isWrite) {
+            await writeGlobalRspFile(filepath, globalRsp);
+            return true;
+        }
+        else
+            return false;
+    }
+    catch (error) {
+        return null;
+    }
+}
+export async function enableRSP() {
+    if (pathinfo.isGdk && pathinfo.gamepath) {
+        const ids = [], gamepath = path.join(pathinfo.gamepath, "../../..");
+        if (config.compiler?.gdkUserId && /^\d+$/.test(config.compiler.gdkUserId))
+            ids.push(config.compiler.gdkUserId);
+        else
+            ids.push(...(await fsp.readdir(gamepath, { withFileTypes: false })).filter((id) => id !== "Shared"));
+        const [uuid] = await Promise.all([BuildCache.get("uuid")]);
+        if (!uuid)
+            return;
+        await Promise.all(ids.map(async (id) => enable(uuid[0], version, getGlobalResourcePackFile(path.join(gamepath, id, "games/com.mojang"))).then(v => {
+            if (v) {
+                Log("INFO", "Resource Pack enabled automaticly for " + id);
+            }
+        })));
+    }
+    else if (pathinfo.gamepath) {
+        const [uuid] = await Promise.all([BuildCache.get("uuid")]);
+        if (!uuid)
+            return;
+        await enable(uuid[0], version, getGlobalResourcePackFile(pathinfo.gamepath)).then(v => {
+            if (v) {
+                Log("INFO", "Resource Pack enabled automaticly");
+            }
+        });
+    }
+}
+export async function disableRSP() {
+    if (pathinfo.isGdk && pathinfo.gamepath) {
+        const gamepath = path.join(pathinfo.gamepath, "../../..");
+        const [uuid] = await Promise.all([BuildCache.get("uuid")]);
+        if (!uuid)
+            return;
+        await Promise.all((await fsp.readdir(gamepath, { withFileTypes: false })).map(async (id) => disable(uuid[0], getGlobalResourcePackFile(path.join(gamepath, id, "games/com.mojang"))).then(v => {
+            if (v) {
+                Log("INFO", "Resource Pack disabled automaticly for " + id);
+            }
+        })));
+    }
+    else if (pathinfo.gamepath) {
+        const [uuid] = await Promise.all([BuildCache.get("uuid")]);
+        if (!uuid)
+            return;
+        await disable(uuid[0], getGlobalResourcePackFile(pathinfo.gamepath)).then(v => {
+            if (v) {
+                Log("INFO", "Resource Pack disabled automaticly");
+            }
+        });
+    }
+}
 export function getGamedataPath() {
-    switch (os.platform()) {
+    switch (pathinfo.os) {
         case "win32": {
             if (/Windows (10|11)/.test(os.version())) {
-                return path.join(process.env.APPDATA, "Minecraft Bedrock\\Users\\Shared\\games\\com.mojang");
+                let gamedata = path.join(process.env.APPDATA, config.compiler?.importToPreview ? "Minecraft Bedrock Preview" : "Minecraft Bedrock", "\\Users\\Shared\\games\\com.mojang");
+                if (fs.existsSync(gamedata)) {
+                    pathinfo.isGdk = true;
+                    return (pathinfo.gamepath = gamedata);
+                }
+                gamedata = path.join(process.env.LOCALAPPDATA, "Packages", config.compiler?.importToPreview
+                    ? "Microsoft.MinecraftWindowsBeta_8wekyb3d8bbwe"
+                    : "Microsoft.MinecraftUWP_8wekyb3d8bbwe", "LocalState\\games\\com.mojang");
+                if (fs.existsSync(gamedata)) {
+                    return (pathinfo.gamepath = gamedata);
+                }
             }
         }
         default: {
-            console.error(`Your platform is not supported the install feature yet! \nYour OS version: ${os.version()}`);
-            process.exit(1);
+            console.warn(`Your platform is not supported the install feature yet! \nYour OS version: ${os.version()}`);
         }
     }
 }

package/dist/js/compilers/ui/linker.js

@@ -2,7 +2,8 @@ import fs from "fs/promises";
 import { BuildCache } from "./buildcache.js";
 import { RandomString } from "../../components/Utils.js";
 import path from "path";
-import { getGamedataPath } from "./installer.js";
+import { getGamedataPath, pathinfo } from "./installer.js";
+import { Log } from "../PreCompile.js";
 const HEX = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));
 function genUUID() {
     const b = Array.from({ length: 16 }, () => Math.floor(Math.random() * 256));
@@ -18,28 +19,45 @@ function genUUID() {
 }
 export async function clearBuild() {
     const files = (await BuildCache.get("build-files")) || [];
-    await Promise.all(files.map(file => fs.rm(`build/${file}`).catch(() => null)));
+    await Promise.all(files.map(file => fs.rm(`build/${file}`).catch(() => null))).then(() => {
+        if (files.length) {
+            Log("INFO", `Build folder cleared (${files.length} files removed)!`);
+        }
+    });
 }
 export async function createBuildFolder() {
     return fs
         .stat("build")
-        .catch(() => fs.mkdir("build"))
+        .catch(() => fs.mkdir("build").then(() => Log("INFO", "Build folder created!")))
         .then(() => clearBuild());
 }
 export async function getBuildFolderName() {
     return await BuildCache.getWithSetDefault("build-key", () => RandomString(16));
 }
+export let gamePath = null;
 export async function linkToGame() {
-    const sourcePath = path.resolve("build");
-    const targetPath = path.resolve(getGamedataPath(), "development_resource_packs", await getBuildFolderName());
-    await fs.stat(targetPath).catch(async () => {
-        await fs.symlink(sourcePath, targetPath, "junction");
-    });
+    const gamedataPath = getGamedataPath();
+    await BuildCache.set("last-gamedata-path", pathinfo);
+    if (gamedataPath) {
+        const sourcePath = path.resolve("build");
+        const targetPath = path.resolve(gamedataPath, "development_resource_packs", await getBuildFolderName());
+        await fs.stat(targetPath).catch(async () => {
+            await fs
+                .symlink(sourcePath, targetPath, "junction")
+                .then(() => Log("INFO", "Linked build folder to gamedata!"));
+        });
+        gamePath = gamedataPath;
+    }
+    else
+        console.warn("No gamedata path found, cannot link!");
 }
 export async function unlink() {
-    const targetPath = path.resolve(getGamedataPath(), "development_resource_packs", await getBuildFolderName());
+    const gamedataPath = await BuildCache.get("last-gamedata-path");
+    if (!gamedataPath?.gamepath)
+        return;
+    const targetPath = path.resolve(gamedataPath.gamepath, "development_resource_packs", await getBuildFolderName());
     try {
-        await fs.unlink(targetPath);
+        await fs.unlink(targetPath).then(() => Log("INFO", "Unlinked build folder from gamedata!"));
     }
     catch (error) {
         console.error(error);

package/dist/js/compilers/ui/manifest.js

@@ -1,5 +1,6 @@
 import { config } from "../Configuration.js";
 import { getUUID } from "./linker.js";
+export const version = config.packinfo?.version || [4, 0, 0];
 export async function genManifest() {
     const [uuid1, uuid2] = await getUUID();
     return JSON.stringify({
@@ -8,7 +9,7 @@ export async function genManifest() {
             name: config.packinfo?.name || "AsaJS",
             description: config.packinfo?.description || "Create your Minecraft JSON-UI resource packs using JavaScript.",
             uuid: uuid1,
-            version: config.packinfo?.version || [4, 0, 0],
+            version,
             min_engine_version: [1, 21, 80],
         },
         modules: [
@@ -16,7 +17,7 @@ export async function genManifest() {
                 description: "This resource pack generate by AsaJS.",
                 type: "resources",
                 uuid: uuid2,
-                version: [4, 0, 0],
+                version: version,
             },
         ],
         subpacks: config.packinfo?.subpacks,

package/dist/types/compilers/PreCompile.d.ts

@@ -6,4 +6,6 @@ declare global {
         lastItem(): T;
     }
 }
+type LogType = "INFO";
+export declare function Log(type: LogType, message: string): void;
 export {};

package/dist/types/compilers/ui/installer.d.ts

@@ -1 +1,11 @@
-export declare function getGamedataPath(): string;
+export interface PathInfo<Platform = NodeJS.Platform> {
+    os: Platform;
+    isGdk: Platform extends "win32" ? boolean : never;
+    gamepath: string | null;
+}
+export declare const pathinfo: PathInfo;
+export declare function enable(uuid: string, version: [number, number, number], filepath: string): Promise<boolean | null>;
+export declare function disable(uuid: string, filepath: string): Promise<boolean | null>;
+export declare function enableRSP(): Promise<void>;
+export declare function disableRSP(): Promise<void>;
+export declare function getGamedataPath(): string | undefined;

package/dist/types/compilers/ui/linker.d.ts

@@ -1,6 +1,7 @@
 export declare function clearBuild(): Promise<void>;
 export declare function createBuildFolder(): Promise<void>;
 export declare function getBuildFolderName(): Promise<string>;
+export declare let gamePath: string | null;
 export declare function linkToGame(): Promise<void>;
 export declare function unlink(): Promise<void>;
 export declare function getUUID(): Promise<[string, string]>;

package/dist/types/compilers/ui/manifest.d.ts

@@ -1 +1,2 @@
+export declare const version: [number, number, number];
 export declare function genManifest(): Promise<string>;