@nixia/2d 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aedan
+
+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

@@ -1,3 +1,6 @@
-# Temporary Holding Version
+# Nixia 2D Game Engine
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## Getting started
+```bash
+npm i -D @aedanmaki/nixia-2d
+```

package/cli.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import * as fs from 'fs';
+import * as path from 'path';
+
+const BASE_URL = "https://nixia-2d-cli.nakoyasoftware.com/components/";
+
+// Define all components in a single configuration array to maintain DRY principles
+const COMPONENTS = [
+    { name: "index.html", dest: "index.html" },
+    { name: "vite.config.ts", dest: "vite.config.ts" },
+    { name: "tsconfig.json", dest: "tsconfig.json" },
+    { name: "main.ts", dest: path.join("src", "main.ts") }
+];
+
+/**
+ * Generic helper function to download any file from the remote components repository.
+ */
+async function downloadFile(filename) {
+    try {
+        const response = await fetch(`${BASE_URL}${filename}`);
+        if (!response.ok) {
+            throw new Error(`HTTP Error: ${response.status} ${response.statusText}`);
+        }
+        return await response.text();
+    } catch (e) {
+        throw new Error(`Failed to download '${filename}': ${e.message}`);
+    }
+}
+
+async function runCli() {
+    console.log('🔍 Running pre-flight environment checks...');
+
+    // Centralized pre-flight checks to prevent accidental overwrites
+    const existenceChecks = [
+        { target: "src", message: "Error: The 'src/' directory already exists. Aborting to protect your files." },
+        { target: "tsconfig.json", message: "Error: 'tsconfig.json' already exists in this directory." },
+        { target: "vite.config.ts", message: "Error: 'vite.config.ts' already exists in this directory." }
+    ];
+
+    for (const check of existenceChecks) {
+        if (fs.existsSync(check.target)) {
+            throw new Error(check.message);
+        }
+    }
+    console.log('✅ Pre-flight checks passed successfully!');
+
+    console.log('🚀 Downloading project components from remote server...');
+    const downloadedContent = {};
+
+    // Loop through our configuration array instead of writing duplicate functions
+    for (let i = 0; i < COMPONENTS.length; i++) {
+        const component = COMPONENTS[i];
+        console.log(`📥 Downloading component ${i + 1} of ${COMPONENTS.length}: ${component.name}...`);
+        downloadedContent[component.name] = await downloadFile(component.name);
+    }
+
+    console.log('💾 Writing files to disk...');
+    
+    // Ensure the src directory exists before writing nested files
+    fs.mkdirSync("src", { recursive: true });
+
+    // Write all downloaded files to their respective destinations
+    for (const component of COMPONENTS) {
+        let content = downloadedContent[component.name];
+
+        // Pretty-print tsconfig.json so it looks clean and readable for humans
+        if (component.name === "tsconfig.json") {
+            try {
+                const parsedJson = JSON.parse(content);
+                content = JSON.stringify(parsedJson, null, 2);
+            } catch (jsonError) {
+                console.warn(`⚠️ Warning: Could not parse downloaded tsconfig.json as JSON. Writing raw text.`);
+            }
+        }
+
+        fs.writeFileSync(component.dest, content);
+    }
+    console.log('✅ All components written to disk successfully!');
+
+    console.log('📦 Updating package.json configuration...');
+    const packageJsonPath = path.join("package.json");
+    
+    if (fs.existsSync(packageJsonPath)) {
+        const packageData = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        
+        // Safely inject scripts and type module setting
+        packageData.scripts = {
+            ...(packageData.scripts || {}),
+            "dev": "vite",
+            "build": "vite build",
+            "preview": "vite preview"
+        };
+        packageData.type = "module";
+
+        fs.writeFileSync(packageJsonPath, JSON.stringify(packageData, null, 2));
+        console.log('✨ package.json updated successfully with Vite scripts and ESM type!');
+    } else {
+        console.warn('⚠️ Warning: package.json not found in the current directory. Skipping script injection.');
+    }
+
+    console.log('🎉 Project scaffolding completed successfully! Happy coding! 🚀✨');
+}
+
+// Global execution wrapper with robust error catching
+runCli().catch((error) => {
+    console.error(`\n💥 Fatal CLI Error: ${error.message}`);
+    process.exit(1);
+});

package/cli.json

@@ -0,0 +1,3 @@
+{
+    "url": "https://nixia-2d-cli.nakoyasoftware.com/"
+}

package/index.html

@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Nixia Engine</title>
+    </head>
+    <body>
+        <script type="module" src="./src/main.ts"></script>
+    </body>
+</html>

package/package.json

@@ -1,6 +1,31 @@
 {
-  "name": "@nixia/2d",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@nixia/2d",
+    "version": "0.0.2",
+    "author": {
+        "name": "Aedan Maki",
+        "email": "aedanmaki@gmail.com"
+    },
+    "bin": "./cli.js",
+    "license": "MIT",
+    "type": "module",
+    "main": "./src/index.ts",
+    "module": "./src/index.ts",
+    "exports": {
+        ".": {
+            "import": "./src/index.ts",
+            "types": "./src/index.ts"
+        }
+    },
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview"
+    },
+    "dependencies": {
+        "fs": "^0.0.1-security",
+        "path": "^0.12.7",
+        "typescript": "^7.0.2",
+        "vite": "^8.3.5",
+        "vite-plugin-singlefile": "^2.3.4"
+    }
+}

package/src/core/Actor.ts

@@ -0,0 +1,14 @@
+// src/core/Actor.ts
+import { Base } from "./Base";
+
+/**
+ * Represents an Actor.
+ */
+export class Actor extends Base {
+    /**
+     * Creates a new Actor.
+     */
+    constructor() {
+        super();
+    }
+}

package/src/core/Application.ts

@@ -0,0 +1,51 @@
+// src/core/Application.ts
+import { Base } from "./Base";
+
+/**
+ * Represents an Application.
+ */
+export class Application extends Base {
+    /**
+     * If the game has already been initialized.
+     */
+    private wasInitialized: boolean = false;
+
+    /**
+     * Creates a new Application.
+     */
+    constructor() {
+        super();
+    }
+
+    /**
+     * Initialize the Application.
+     */
+    init() {
+        if (this.wasInitialized) throw new Error('Application is already initialized.');
+        this.wasInitialized = true;
+
+        if (document.readyState === 'complete') {
+            this._ready();
+        } else {
+            window.addEventListener('load', () => {
+                this._ready();
+            });
+        }
+    }
+
+    /**
+     * Called when the game is ready.
+     */
+    private _ready() {
+        this.fire('ready');
+
+        requestAnimationFrame(this._tick);
+    }
+
+    /**
+     * Called on tick.
+     */
+    private _tick = () => {
+        requestAnimationFrame(this._tick);
+    }
+}

package/src/core/Base.ts

@@ -0,0 +1,25 @@
+// src/core/Base.ts
+
+/**
+ * Base class containing code for replication and events.
+ */
+export abstract class Base {
+    private events: Map<string, Function[]> = new Map();
+
+    on(event: string, callback: Function) {
+        const callbacks = this.events.get(event);
+        if (!callbacks) this.events.set(event, [callback]); else {
+            callbacks.push(callback);
+            this.events.set(event, callbacks);
+        }
+    }
+
+    fire(event: string) {
+        const callbacks = this.events.get(event);
+        if (!callbacks) return;
+        const len = callbacks.length;
+        for (let i = 0; i < len; i++) {
+            callbacks[i]();
+        }
+    }
+}

package/src/core/Level.ts

@@ -0,0 +1,14 @@
+// src/core/Level.ts
+import { Base } from "./Base";
+
+/**
+ * Represents a Level.
+ */
+export class Level extends Base {
+    /**
+     * Creates a new Level.
+     */
+    constructor() {
+        super();
+    }
+}

package/src/core/Renderer.ts

@@ -0,0 +1,14 @@
+// src/core/Renderer.ts
+import { Base } from "./Base";
+
+/**
+ * Represents a Renderer.
+ */
+export class Renderer extends Base {
+    /**
+     * Creates a new Renderer.
+     */
+    constructor() {
+        super();
+    }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+// src/index.ts
+
+export * from './core/Actor';
+export * from './core/Application';
+export * from './core/Base';
+export * from './core/Level';
+export * from './core/Renderer';

package/src/main.ts

@@ -0,0 +1,4 @@
+import * as NIXIA from './index';
+
+const app = new NIXIA.Application();
+app.init();

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "isolatedModules": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src/**/*", "vite.config.ts"]
+}

package/vite.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vite';
+import { viteSingleFile } from 'vite-plugin-singlefile';
+
+export default defineConfig({
+    plugins: [viteSingleFile()],
+    build: {
+        target: 'esnext',
+        assetsInlineLimit: 100000000,
+        chunkSizeWarningLimit: 100000000,
+        cssCodeSplit: false,
+        rollupOptions: {
+            output: {
+                inlineDynamicImports: true,
+            },
+        },
+    },
+});