unreal-toolkit 0.0.1

package/README.md

@@ -0,0 +1,18 @@
+# Unreal Toolkit - Classic Edition
+A universal runtime library for advanced Unreal Engine web game development. The **Unreal Toolkit** requires
+the **TOOLKIT** namespaces to be globally accessible.
+
+<a href="https://www.npmjs.com/package/unreal-toolkit-next">Next Edition (ES6)</a>
+<br/>
+<a href="https://github.com/UnrealJS/UnrealToolkit/tree/master/Runtime">Browser Edition (CDN)</a>
+
+
+## Default Installation (UMD)
+```bash
+npm install unreal-toolkit
+```
+
+* Default Toolkit Import Libraries
+```javascript
+import TOOLKIT from 'unreal-toolkit';
+```

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+/** UMD Type References */
+/**
+ * Unreal Toolkit (Static Manager Pattern)
+ * @class UnrealToolkit - All rights reserved (c) 2024 Mackey Kinard
+ */
+export declare class UnrealToolkit {
+    private static _EventBus;
+    /** Unreal Toolkit event message bus
+     * @example
+     * ```typescript
+     * // Handle myevent message
+     * UnrealToolkit.EventBus.OnMessage("myevent", (data:string) => {
+     *    console.log("My Event Data: " + data);
+     * });
+     *
+     * // Post myevent message
+     * UnrealToolkit.EventBus.PostMessage("myevent", "Hello World!");
+     * ```
+    */
+    static get EventBus(): UnrealMessageBus;
+}
+/**
+ * Unreal Toolkit Message Bus (Asynchronous Post Message Communication)
+ * @class UnrealMessageBus - All rights reserved (c) 2024 Mackey Kinard
+ */
+export declare class UnrealMessageBus {
+    constructor();
+    /** Handle event bus message
+     * @param message The message to handle
+     * @param data The data to handle
+     * @returns void
+     */
+    OnMessage(message: string, handler: (data: string) => void): void;
+    /** Post event bus message
+     * @param message The message to post
+     * @param data The data to post
+     * @param target The target to post
+     * @param transfer The transfer to post
+     * @returns void
+     */
+    PostMessage(message: string, data?: string): void;
+    /** Remove event bus message handler
+     * @param message The message to remove
+     * @param handler The handler to remove
+     * @returns void
+     */
+    RemoveHandler(message: string, handler: (data: string) => void): void;
+    /** Clear and reset all event bus message handlers
+     * @returns void
+     */
+    ResetHandlers(): void;
+    /** Dispose the unreal message bus
+     * @returns void
+     */
+    Dispose(): void;
+    /** Handle window message event
+     * @param event The message event to handle
+     * @returns void
+     */
+    private HandleWindowMessage;
+    /** Dispatch internal event bus message
+     * @param message The message to dispatch
+     * @param data The data to dispatch
+     * @returns void
+     */
+    private OnDispatchMessage;
+    private ListenerDictionary;
+}
+export default UnrealToolkit;

package/dist/unreal.toolkit.d.ts

@@ -0,0 +1,69 @@
+/** UMD Type References */
+/**
+ * Unreal Toolkit (Static Manager Pattern)
+ * @class UnrealToolkit - All rights reserved (c) 2024 Mackey Kinard
+ */
+export declare class UnrealToolkit {
+    private static _EventBus;
+    /** Unreal Toolkit event message bus
+     * @example
+     * ```typescript
+     * // Handle myevent message
+     * UnrealToolkit.EventBus.OnMessage("myevent", (data:string) => {
+     *    console.log("My Event Data: " + data);
+     * });
+     *
+     * // Post myevent message
+     * UnrealToolkit.EventBus.PostMessage("myevent", "Hello World!");
+     * ```
+    */
+    static get EventBus(): UnrealMessageBus;
+}
+/**
+ * Unreal Toolkit Message Bus (Asynchronous Post Message Communication)
+ * @class UnrealMessageBus - All rights reserved (c) 2024 Mackey Kinard
+ */
+export declare class UnrealMessageBus {
+    constructor();
+    /** Handle event bus message
+     * @param message The message to handle
+     * @param data The data to handle
+     * @returns void
+     */
+    OnMessage(message: string, handler: (data: string) => void): void;
+    /** Post event bus message
+     * @param message The message to post
+     * @param data The data to post
+     * @param target The target to post
+     * @param transfer The transfer to post
+     * @returns void
+     */
+    PostMessage(message: string, data?: string): void;
+    /** Remove event bus message handler
+     * @param message The message to remove
+     * @param handler The handler to remove
+     * @returns void
+     */
+    RemoveHandler(message: string, handler: (data: string) => void): void;
+    /** Clear and reset all event bus message handlers
+     * @returns void
+     */
+    ResetHandlers(): void;
+    /** Dispose the unreal message bus
+     * @returns void
+     */
+    Dispose(): void;
+    /** Handle window message event
+     * @param event The message event to handle
+     * @returns void
+     */
+    private HandleWindowMessage;
+    /** Dispatch internal event bus message
+     * @param message The message to dispatch
+     * @param data The data to dispatch
+     * @returns void
+     */
+    private OnDispatchMessage;
+    private ListenerDictionary;
+}
+export default UnrealToolkit;

package/dist/unreal.toolkit.js

@@ -0,0 +1 @@
+!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports.TOOLKIT=n():e.TOOLKIT=n()}(this,(()=>(()=>{"use strict";var e={d:(n,t)=>{for(var o in t)e.o(t,o)&&!e.o(n,o)&&Object.defineProperty(n,o,{enumerable:!0,get:t[o]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)},n={};e.d(n,{default:()=>s});var t=function(){function e(){}return Object.defineProperty(e,"EventBus",{get:function(){return null==e._EventBus&&(e._EventBus=new o),e._EventBus},enumerable:!1,configurable:!0}),e._EventBus=null,e}(),o=function(){function e(){this.ListenerDictionary={},window&&window.top?(this.HandleWindowMessage=this.HandleWindowMessage.bind(this),window.top.addEventListener("message",this.HandleWindowMessage)):console.warn("UnrealMessageBus: No Top Window Available")}return e.prototype.OnMessage=function(e,n){var t;null==this.ListenerDictionary[e]?(t=[],this.ListenerDictionary[e]=t):t=this.ListenerDictionary[e],t.findIndex((function(e){return n==e}))<0&&t.push(n)},e.prototype.PostMessage=function(e,n){window&&window.top?window.top.postMessage({source:"unrealmessagebus",message:e,data:n}):console.warn("UnrealMessageBus: No Top Window Available")},e.prototype.RemoveHandler=function(e,n){var t=this.ListenerDictionary[e];if(null!=t){var o=t.findIndex((function(e){return n==e}));o>=0&&t.splice(o,1)}},e.prototype.ResetHandlers=function(){this.ListenerDictionary={}},e.prototype.Dispose=function(){this.ResetHandlers(),window&&window.top&&window.top.removeEventListener("message",this.HandleWindowMessage)},e.prototype.HandleWindowMessage=function(e){null!=e&&null!=e.data&&null!=e.data.message&&null!=e.data.source&&"unrealmessagebus"==e.data.source&&this.OnDispatchMessage(e.data.message,null!=e.data.data?e.data.data:null)},e.prototype.OnDispatchMessage=function(e,n){void 0===n&&(n=null);var t=this.ListenerDictionary[e];null!=t&&t.forEach((function(e){try{e&&e(n)}catch(e){console.warn(e)}}))},e}();"undefined"!=typeof window&&(window.UnrealToolkit=t),console.log("Unreal Toolkit Runtime - Version 0.0.1");const s=t;return n.default})()));

package/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "unreal-toolkit",
+    "version": "0.0.1",
+    "description": "Unreal Toolkit Runtime Library (UMD)",
+    "main": "dist/unreal.toolkit.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "clean": "rimraf dist",
+        "build": "npm run build-all",
+        "build-ts": "webpack --mode production",
+        "build-all": "npm run clean && npm run build-ts && npm run create-dts",
+        "create-dts": "node ./create-dts.js"        
+    },
+    "keywords": [
+        "unrealjs",
+        "unreal-toolkit",
+        "game-development",
+        "wasm",
+        "webgl",
+        "webgpu"
+    ],
+    "files": [
+        "README.md",
+        "package.json",
+        "dist/**/*"
+    ],
+    "devDependencies": {
+        "rimraf": "^6.0.1",
+        "ts-loader": "^9.5.1",
+        "typescript": "^5.5.4",
+        "webpack": "^5.93.0",
+        "webpack-cli": "^5.1.4"
+    }
+}