@inglorious/create-game 1.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright © 2025 Inglorious Coderz Srl.
+
+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,54 @@
+# @inglorious/create-game
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The official scaffolding tool to quickly create a new game with the [Inglorious Engine](https://github.com/IngloriousCoderz/inglorious-engine).
+
+This package allows you to generate a new project from a set of pre-configured templates, so you can start developing your game right away.
+
+## Usage
+
+To create a new game, run one of the following commands in your terminal. You will be prompted to choose a project name and select a template.
+
+```bash
+# with npm
+npm create @inglorious/game@latest
+
+# with yarn
+yarn create @inglorious/game
+
+# with pnpm
+pnpm create @inglorious/game
+```
+
+The CLI will guide you through the setup process, asking for a project name and which template you'd like to use.
+
+## Templates
+
+The following templates are available to get you started:
+
+- **js**: A minimal starter for a plain JavaScript project.
+- **ts**: A minimal starter for a plain TypeScript project.
+- **ijs** (IngloriousScript): A starter template for a JavaScript project using IngloriousScript via Babel.
+- **its** (IngloriousScript w/ TypeScript): A starter template for a TypeScript project that uses IngloriousScript.
+
+## What it does
+
+The tool will create a new directory with your chosen project name and copy the template files into it. It will also automatically update the `package.json` with your project's name.
+
+After the project is created, you can navigate into the directory and install the dependencies.
+
+```bash
+# 1. Change into your new project directory
+cd my-awesome-game
+
+# 2. Install dependencies
+pnpm install
+
+# 3. Start the development server
+pnpm dev
+```
+
+## License
+
+This package is MIT licensed.

package/bin/index.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+import { execSync } from "child_process"
+import fs from "fs"
+import { EOL } from "os"
+import path from "path"
+import prompts from "prompts"
+import { fileURLToPath } from "url"
+
+const INDENTATION = 2
+
+async function main() {
+  const __dirname = path.dirname(fileURLToPath(import.meta.url))
+  const templatesRoot = path.join(__dirname, "../templates")
+
+  let canceled = false
+
+  const onCancel = () => {
+    canceled = true
+    return false
+  }
+
+  const { projectName, template } = await prompts(
+    [
+      {
+        type: "text",
+        name: "projectName",
+        message: "What is your project named?",
+        initial: "my-game",
+      },
+      {
+        type: "select",
+        name: "template",
+        message: "Select a template",
+        choices: [
+          {
+            title: "Minimal",
+            description: "A single HTML file for a zero-build setup",
+            value: "minimal",
+          },
+          {
+            title: "JavaScript",
+            description: "A vanilla JavaScript setup with Vite",
+            value: "js",
+          },
+          {
+            title: "TypeScript",
+            description: "A TypeScript setup with Vite",
+            value: "ts",
+          },
+          {
+            title: "IngloriousScript (JS)",
+            description:
+              "A JS superset with built-in vector math, powered by Vite",
+            value: "ijs",
+          },
+          {
+            title: "IngloriousScript (TS)",
+            description:
+              "A TS superset with built-in vector math, powered by Vite",
+            value: "its",
+          },
+        ],
+      },
+    ],
+    { onCancel },
+  )
+
+  if (canceled) {
+    console.log("Operation canceled.")
+    return
+  }
+
+  const targetDir = path.join(process.cwd(), projectName)
+  const templateDir = path.join(templatesRoot, template)
+
+  // Create project directory and copy template files
+  copyDir(templateDir, targetDir)
+
+  // Update README.md with project name
+  const readmePath = path.join(targetDir, "README.md")
+  if (fs.existsSync(readmePath)) {
+    let readme = fs.readFileSync(readmePath, "utf-8")
+    readme = readme.replace(/# my-game/, `# ${projectName}`)
+    fs.writeFileSync(readmePath, readme)
+  }
+
+  if (template === "minimal") {
+    console.log(`✅ Created ${projectName} at ${targetDir}`)
+    console.log(`\nNext steps:`)
+    console.log(`  cd ${projectName}`)
+    console.log(`  Open index.html in your browser`)
+  } else {
+    // Update package.json with project name
+    const pkgPath = path.join(targetDir, "package.json")
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"))
+    pkg.name = projectName
+
+    function getLatestVersion(packageName) {
+      try {
+        const version = execSync(`npm view ${packageName} version`, {
+          encoding: "utf-8",
+        }).trim()
+        return `^${version}`
+      } catch {
+        return "latest" // fallback
+      }
+    }
+
+    for (const depType of ["dependencies", "devDependencies"]) {
+      if (pkg[depType]) {
+        for (const [name, version] of Object.entries(pkg[depType])) {
+          if (version.startsWith("workspace:")) {
+            pkg[depType][name] = getLatestVersion(name)
+          }
+        }
+      }
+    }
+
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, INDENTATION) + EOL)
+
+    console.log(`✅ Created ${projectName} at ${targetDir}`)
+    console.log(`\nNext steps:`)
+    console.log(`  cd ${projectName}`)
+    console.log(`  pnpm install`)
+    console.log(`  pnpm dev`)
+  }
+
+  function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true })
+
+    const entries = fs.readdirSync(src, { withFileTypes: true })
+
+    for (const entry of entries) {
+      const srcPath = path.join(src, entry.name)
+      const destPath = path.join(dest, entry.name)
+
+      // Rename gitignore to .gitignore
+      if (entry.name === "gitignore") {
+        fs.copyFileSync(srcPath, path.join(dest, ".gitignore"))
+        continue
+      }
+
+      if (entry.isDirectory()) {
+        copyDir(srcPath, destPath)
+      } else {
+        fs.copyFileSync(srcPath, destPath)
+      }
+    }
+  }
+}
+
+main().catch((e) => {
+  console.error(e)
+})

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@inglorious/create-game",
+  "version": "1.0.0",
+  "description": "A scaffolding tool to quickly create a new game with the Inglorious Engine.",
+  "author": "IceOnFire <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IngloriousCoderz/inglorious-engine.git",
+    "directory": "packages/create-game"
+  },
+  "homepage": "https://inglorious-engine.vercel.app/",
+  "bugs": {
+    "url": "https://github.com/IngloriousCoderz/inglorious-engine/issues"
+  },
+  "keywords": [
+    "cli",
+    "create-game",
+    "functional-programming",
+    "gamedev",
+    "game-engine",
+    "inglorious-engine",
+    "scaffolding"
+  ],
+  "type": "module",
+  "bin": {
+    "create-game": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "templates",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "prettier": "^3.6.2",
+    "@inglorious/eslint-config": "1.0.0"
+  },
+  "scripts": {
+    "format": "prettier --write '**/*.{js,ijs,ts,its}'",
+    "lint": "eslint . --ext js,ijs,ts,its --report-unused-disable-directives --max-warnings 0"
+  }
+}

package/templates/ijs/.prettierrc.yml

@@ -0,0 +1,6 @@
+semi: false
+
+overrides:
+  - files: "*.ijs"
+    options:
+      parser: babel

package/templates/ijs/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "files.associations": {
+    "*.ijs": "javascript"
+  }
+}

package/templates/ijs/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright © 2025 Inglorious Coderz Srl.
+
+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/templates/ijs/README.md

@@ -0,0 +1,53 @@
+# ijs-template
+
+This project is a starter template for creating a game with the Inglorious Engine using **IngloriousScript**.
+
+## What is IngloriousScript?
+
+IngloriousScript is a superset of JavaScript that enables intuitive vector math using standard operators, transformed by Babel.
+
+```javascript
+// Instead of this:
+const newPosition = mod(add(position, scale(velocity, dt)), worldSize)
+
+// You can write this:
+const newPosition = (position + velocity * dt) % worldSize
+```
+
+## Getting Started
+
+This project was scaffolded with `@inglorious/create-game`.
+
+To get started, follow these steps:
+
+1.  **Install dependencies**:
+    Navigate to your project directory and install the required packages.
+    ```sh
+    pnpm install
+    ```
+2.  **Start the development server**:
+    Run the following command to start the Vite development server.
+    ```sh
+    pnpm dev
+    ```
+
+This will start a Vite development server. Open your browser to the local URL provided to see it in action.
+
+## Project Setup
+
+- `index.html`: The main entry point for your game.
+- `src/`: Contains your game's source code. Files ending in `.ijs` use IngloriousScript.
+- `vite.config.js`: Vite configuration with the Babel plugin for IngloriousScript.
+- `package.json`: Project metadata and dependencies.
+
+## Editor Configuration (VS Code)
+
+This template includes a `.vscode/settings.json` file that tells Visual Studio Code to treat `.ijs` files as JavaScript, enabling full syntax highlighting and IntelliSense.
+
+```json
+{
+  "files.associations": {
+    "*.ijs": "javascript"
+  }
+}
+```

package/templates/ijs/eslint.config.js

@@ -0,0 +1 @@
+export { default } from "@inglorious/eslint-config/browser"

package/templates/ijs/gitignore

@@ -0,0 +1,48 @@
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Local env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage
+
+# Turbo
+.turbo
+
+# Vercel
+.vercel
+
+# Build Outputs
+.next/
+out/
+build
+dist
+dist-ssr
+storybook-static
+vite.config.js.timestamp-*
+
+# Debug
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Editor directories and files
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.qodo

package/templates/ijs/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/logo.png" />
+    <link rel="stylesheet" href="/style.css" />
+    <title>Inglorious Engine - Game</title>
+  </head>
+
+  <body>
+    <canvas id="canvas" width="800" height="600"></canvas>
+    <script type="module" src="./src/main.js"></script>
+  </body>
+</html>

package/templates/ijs/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "ijs-template",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "description": "A new game created with @inglorious/create-game",
+  "author": "",
+  "license": "MIT",
+  "scripts": {
+    "format": "prettier --write '**/*.{js,ijs}'",
+    "lint": "eslint . --ext js,ijs --report-unused-disable-directives --max-warnings 0",
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@inglorious/engine": "workspace:*",
+    "@inglorious/renderer-2d": "workspace:*"
+  },
+  "devDependencies": {
+    "@inglorious/babel-preset-inglorious-script": "workspace:*",
+    "@inglorious/eslint-config": "workspace:*",
+    "prettier": "^3.6.2",
+    "vite": "^7.1.6",
+    "vite-plugin-babel": "^1.3.2"
+  },
+  "packageManager": "pnpm@10.15.0",
+  "engines": {
+    "node": ">= 22"
+  }
+}

package/templates/ijs/public/style.css

@@ -0,0 +1,36 @@
+* {
+  box-sizing: border-box;
+}
+
+body {
+  font-family: "Press Start 2P", system-ui;
+  width: 100vw;
+  height: 100vh;
+  overflow: hidden;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  background-color: #000;
+  color: #fff;
+}
+
+canvas {
+  max-width: 1280px;
+  max-height: 720px;
+  width: 100vw;
+  height: auto;
+  cursor: none;
+}
+
+@media (orientation: landscape) {
+  canvas {
+    width: auto;
+    height: 100vh;
+  }
+}
+
+img {
+  display: none;
+}

package/templates/ijs/src/game.ijs

@@ -0,0 +1 @@
+export default {}

package/templates/ijs/src/main.js

@@ -0,0 +1,10 @@
+import { Engine } from "@inglorious/engine/core/engine"
+import { createRenderer } from "@inglorious/renderer-2d"
+
+import game from "./game.ijs"
+
+const canvas = document.getElementById("canvas")
+const renderer = createRenderer(canvas)
+const engine = new Engine(renderer, game)
+await engine.init()
+engine.start()

package/templates/ijs/vite.config.js

@@ -0,0 +1,15 @@
+import { defineConfig } from "vite"
+import babel from "vite-plugin-babel"
+
+export default defineConfig({
+  plugins: [
+    babel({
+      include: "src/**",
+      filter: /\.(js|ijs)$/,
+
+      babelConfig: {
+        presets: ["@inglorious/inglorious-script"],
+      },
+    }),
+  ],
+})

package/templates/its/.prettierrc.yml

@@ -0,0 +1,6 @@
+semi: false
+
+overrides:
+  - files: "*.its"
+    options:
+      parser: typescript

package/templates/its/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "files.associations": {
+    "*.its": "typescript"
+  }
+}

package/templates/its/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright © 2025 Inglorious Coderz Srl.
+
+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/templates/its/README.md

@@ -0,0 +1,64 @@
+# its-template
+
+This project is a starter template for creating a game with the Inglorious Engine using **IngloriousScript with TypeScript**.
+
+## What is IngloriousScript?
+
+IngloriousScript is a superset of JavaScript that enables intuitive vector math using standard operators, transformed by Babel.
+
+```typescript
+// Instead of this:
+const newPosition = mod(add(position, scale(velocity, dt)), worldSize)
+
+// You can write this:
+// @ts-expect-error - IngloriousScript operators are transformed by Babel
+const newPosition = (position + velocity * dt) % worldSize
+```
+
+## Getting Started
+
+This project was scaffolded with `@inglorious/create-game`.
+
+To get started, follow these steps:
+
+1.  **Install dependencies**:
+    Navigate to your project directory and install the required packages.
+    ```sh
+    pnpm install
+    ```
+2.  **Start the development server**:
+    Run the following command to start the Vite development server.
+    ```sh
+    pnpm dev
+    ```
+
+This will start a Vite development server. Open your browser to the local URL provided to see it in action.
+
+## Project Setup
+
+- `index.html`: The main entry point for your game.
+- `src/`: Contains your game's source code. Files ending in `.its` use IngloriousScript with TypeScript.
+- `vite.config.js`: Vite configuration with the Babel plugin for IngloriousScript.
+- `tsconfig.json`: TypeScript configuration.
+- `package.json`: Project metadata and dependencies.
+
+### Using `.its` files
+
+The `.its` extension is for TypeScript files that use IngloriousScript's operator overloading. Since TypeScript doesn't natively support this, you must add a `@ts-expect-error` comment above lines with vector operations. This is normal and expected.
+
+```typescript
+// @ts-expect-error - IngloriousScript operators are transformed by Babel
+const newPosition = (position + velocity * deltaTime) % worldSize
+```
+
+### Editor Configuration (VS Code)
+
+This template includes a `.vscode/settings.json` file that tells Visual Studio Code to treat `.its` files as TypeScript, enabling full syntax highlighting and IntelliSense.
+
+```json
+{
+  "files.associations": {
+    "*.its": "typescript"
+  }
+}
+```

package/templates/its/eslint.config.js

@@ -0,0 +1 @@
+export { default } from "@inglorious/eslint-config/browser"

package/templates/its/gitignore

@@ -0,0 +1,48 @@
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Local env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage
+
+# Turbo
+.turbo
+
+# Vercel
+.vercel
+
+# Build Outputs
+.next/
+out/
+build
+dist
+dist-ssr
+storybook-static
+vite.config.js.timestamp-*
+
+# Debug
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Editor directories and files
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.qodo

package/templates/its/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/logo.png" />
+    <link rel="stylesheet" href="/style.css" />
+    <title>Inglorious Engine - Game</title>
+  </head>
+
+  <body>
+    <canvas id="canvas" width="800" height="600"></canvas>
+    <script type="module" src="./src/main.js"></script>
+  </body>
+</html>