visualcopium 1.0.8 → 1.1.0

package/README.md

@@ -0,0 +1,61 @@
+<div align="center">
+	<h1>Visualcopium</h1>
+	<p>Copium for visual programmers!</p>
+</div>
+
+---
+
+You don't need a silly custom language, you don't need Scratch. You need a brittle cross between semi-real code (aka JavaScript, but how real is that?) and visualness!
+
+[(skip to installation)](#installation)
+
+**Visualcopium** does just that! We provide separate "blocks" for both the web and Node.js/Bun, but also some generic ones. And to prove its amazingness, here's some examples:
+
+Repeating is fun!
+
+```javascript
+Repeat(10 /*times*/, () => {
+	// some code that does stuff 10 times :)
+	var message = Ask("Do you wanna? ")                   // you can ask the user stuff!
+	Say("Here's a number anyways! " + PickRandom(1, 100)) // you can say stuff back!
+})
+
+var canBeFalseIdfk = true
+RepeatWhile(() => canBeFalseIdfk, () => {
+	canBeFalseIdfk = false
+	Say("Yay canBeFalseIdfk is now false!")
+})
+
+RepeatWhile(false, () => { // Your condition can also directly be a boolean! Or a number, anything except 0 becomes true.
+	SayError("Bro if you can see this your computer might be broken :(")
+})
+
+Forever(() => {
+	// dude this'll NEVER stop :sob:
+	SayError("Why did you finish already? Here's an error you ajfojafjiwaifju!!")
+
+	if (KeyPressed("Escape")) {
+		SayError("There is no escape!")
+	}
+})
+```
+
+### Installation
+
+And if you're a silly person, there's an optional block that waits for this supposed page to load:
+
+```javascript
+WhenFlagClicked(() => {
+	// some code that does stuff AFTER the page loads...
+})
+```
+
+You can either install our JavaScript (NPM) package globally, or make a lil project folder. Either way!
+
+```bash
+npm install -g visualcopium
+
+# ORRRR make your own lil project folder :)
+npm init
+npm install visualcopium
+```

package/dist/dom.d.ts

@@ -0,0 +1,40 @@
+import type { Vec2n } from "./typing.js";
+export type BrowserKey = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "Space" | "Enter" | "Backspace" | "Tab" | "Escape" | "Shift" | "Ctrl" | "Alt" | "Up Arrow" | "Down Arrow" | "Left Arrow" | "Right Arrow" | "Caps Lock" | "Delete" | "Home" | "End" | "Page Up" | "Page Down" | "Insert" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | "`" | "-" | "=" | "[" | "]" | "\\" | ";" | "'" | "," | "." | "/";
+/**
+ * Code will run once the page finishes loading.
+ * @param callback Code block/function
+ */
+export declare function WhenFlagClicked(callback: () => void): void;
+/**
+ * Code will run when a specific key is pressed.
+ * @param key Key to look for
+ * @param callback Code block/function
+ */
+export declare function WhenKeyPressed(key: BrowserKey, callback: () => void): void;
+/**
+ * Returns whether a specific key is pressed.
+ * @param key Key to look for
+ * @returns Whether a specific key is pressed
+ */
+export declare function KeyPressed(key: BrowserKey): boolean;
+/**
+ * Returns whether the mouse is pressed down.
+ * @returns Whether the mouse is pressed down
+ */
+export declare function MouseDown(): boolean;
+/**
+ * Returns the mouse's position as a vector object. Use `MouseX();` and `MouseY();` for simplified return values!
+ * @returns Mouse's position (Vec2n)
+ */
+export declare function MousePosition(): Vec2n;
+/**
+ * Return's the mouse's X position.
+ * @returns Mouse's X position
+ */
+export declare function MouseX(): number;
+/**
+ * Return's the mouse's Y position.
+ * @returns Mouse's Y position
+ */
+export declare function MouseY(): number;
+//# sourceMappingURL=dom.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+import type { Condition } from "./typing.js";
+declare global {
+    interface Window {
+        VC_pressedKeys: Set<String>;
+        VC_keyPressListeners: Map<string, (() => void)[]>;
+        VC_mouseDown: boolean;
+    }
+}
+/**
+ * Repeats the code block/function a number of times.
+ * @param times Number of times to repeat
+ * @param callback Code block/function
+ */
+export declare function Repeat(times: number, callback: () => void): void;
+/**
+ * Repeats the code block/function until a condition is finally true.
+ * @param condition Either a code block/function that returns a boolean or an expression that evaluates to one.
+ * @param callback Code block/function
+ */
+export declare function RepeatUntil(condition: Condition, callback: () => void): void;
+/**
+ * Repeats the code block/function until a condition is no longer true.
+ * @param condition Either a code block/function that returns a boolean or an expression that evaluates to one.
+ * @param callback Code block/function
+ */
+export declare function RepeatWhile(condition: Condition, callback: () => void): void;
+/**
+ * Repeats the code block/function forever. Everything after will now continue while this repeats!
+ * @param callback Code block/function
+ */
+export declare function Forever(callback: () => void): void;
+/**
+ * Picks random integer between a minimum and maximum (inclusive)
+ * @param minimum Minimum integer
+ * @param maximum Maximum integer
+ * @returns Random integer
+ */
+export declare function PickRandom(minimum: number, maximum: number): number;
+/**
+ * Asks the user a question and waits for a response.
+ * @param message Question/message to ask
+ * @returns User's response
+ */
+export declare function Ask(message: string): string;
+/**
+ * Says a message.
+ * @param message Message to say
+ */
+export declare function Say(message: string): void;
+/**
+ * Says a message in the form of a warning.
+ * @param warning Warning message to say
+ */
+export declare function SayWarning(warning: string): void;
+/**
+ * Says a message in the form of an error.
+ * @param error Error message to say
+ */
+export declare function SayError(error: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -35,12 +35,11 @@ export function RepeatWhile(condition, callback) {
         callback();
 }
 /**
- * Repeats the code block/function forever. Use sparingly! Not recommended for browser use, will lag crazily. This is something we cannot fix.
+ * Repeats the code block/function forever. Everything after will now continue while this repeats!
  * @param callback Code block/function
  */
 export function Forever(callback) {
-    while (true)
-        callback();
+    setInterval(callback, 0);
 }
 // Math
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,UAAU;AAEV;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,QAAoB;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QAAE,QAAQ,EAAE,CAAA;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoB,EAAE,QAAoB;IACrE,OACC,CAAC,CAAC,GAAG,EAAE,CACN,OAAO,SAAS,IAAI,QAAQ;QAC3B,CAAC,CAAC,SAAS,IAAI,CAAC;QAChB,CAAC,CAAC,OAAO,SAAS,IAAI,SAAS;YAC9B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE;QAEnB,QAAQ,EAAE,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoB,EAAE,QAAoB;IACrE,OACC,CAAC,GAAG,EAAE,CACL,OAAO,SAAS,IAAI,QAAQ;QAC3B,CAAC,CAAC,SAAS,IAAI,CAAC;QAChB,CAAC,CAAC,OAAO,SAAS,IAAI,SAAS;YAC9B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE;QAEnB,QAAQ,EAAE,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,QAAoB;IAC3C,OAAO,IAAI;QAAE,QAAQ,EAAE,CAAA;AACxB,CAAC;AAED,OAAO;AAEP;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAe;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AACzE,CAAC;AAED,MAAM;AAEN;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe;IAClC,IAAI,CAAC,OAAO,MAAM,IAAI,WAAW,IAAI,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,OAAO,MAAM,IAAI,UAAU;QAC7F,OAAO,MAAM,CAAC,OAAO,EAAE,EAAE,CAAE,CAAA;IAE5B,GAAG,CACF,2GAA2G,CAC3G,CAAA;IAED,OAAO,EAAE,CAAA;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,UAAU;AAEV;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,QAAoB;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QAAE,QAAQ,EAAE,CAAA;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoB,EAAE,QAAoB;IACrE,OACC,CAAC,CAAC,GAAG,EAAE,CACN,OAAO,SAAS,IAAI,QAAQ;QAC3B,CAAC,CAAC,SAAS,IAAI,CAAC;QAChB,CAAC,CAAC,OAAO,SAAS,IAAI,SAAS;YAC9B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE;QAEnB,QAAQ,EAAE,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoB,EAAE,QAAoB;IACrE,OACC,CAAC,GAAG,EAAE,CACL,OAAO,SAAS,IAAI,QAAQ;QAC3B,CAAC,CAAC,SAAS,IAAI,CAAC;QAChB,CAAC,CAAC,OAAO,SAAS,IAAI,SAAS;YAC9B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE;QAEnB,QAAQ,EAAE,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,QAAoB;IAC3C,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;AACzB,CAAC;AAED,OAAO;AAEP;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAe;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AACzE,CAAC;AAED,MAAM;AAEN;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe;IAClC,IAAI,CAAC,OAAO,MAAM,IAAI,WAAW,IAAI,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,OAAO,MAAM,IAAI,UAAU;QAC7F,OAAO,MAAM,CAAC,OAAO,EAAE,EAAE,CAAE,CAAA;IAE5B,GAAG,CACF,2GAA2G,CAC3G,CAAA;IAED,OAAO,EAAE,CAAA;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC"}

package/dist/typing.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Defines either a code block/function that returns a boolean or an expression that evaluates to one.
+ */
+export type Condition = (() => boolean) | boolean | 0 | 1;
+/**
+ * Defines a generic object type which can store two values of the same type. Look into `Vec2n` for the strictly numerical variant!
+ */
+export type Vec2<T> = {
+    x: T;
+    y: T;
+};
+/**
+ * Defines an object type containing two numbers.
+ */
+export type Vec2n = Vec2<number>;
+/**
+ * Defines a generic object type which can store three values of the same type. Look into `Vec3n` for the strictly numerical variant!
+ */
+export type Vec3<T> = {
+    x: T;
+    y: T;
+};
+/**
+ * Defines an object type containing three numbers.
+ */
+export type Vec3n = Vec2<number>;
+//# sourceMappingURL=typing.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "visualcopium",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "author": {
     "url": "https://github.com/boyninja1555",
     "email": "flappyfloorg@gmail.com",