@evitcastudio/kit 3.3.2 → 3.5.0

package/README.md

@@ -1,27 +1,80 @@
-# Kit
+<p align="center">
+  <img src="./evitcastudio_round_branding.png" width="128" height="128" alt="Evitca Studio Logo" />
+</p>
 
-**Kit** is a lightweight, extensible 2D framework for game development in the [Vylocity Game Engine](https://www.vylocity.com/). Designed to be simple and modular, Kit empowers developers to build complex projects quickly through a robust plugin-driven architecture.
+<h1 align="center">@evitcastudio/kit</h1>
+
+<p align="center">
+  A lightweight, extensible framework and developer toolkit for the Vylocity Game Engine.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@evitcastudio/kit"><img src="https://img.shields.io/npm/v/@evitcastudio/kit.svg?color=10b981" alt="npm version" /></a>
+  <a href="https://github.com/EvitcaStudio/Kit/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
+  <a href="https://github.com/EvitcaStudio/Kit"><img src="https://img.shields.io/badge/TypeScript-Ready-3178c6.svg" alt="TypeScript" /></a>
+</p>
+
+---
+
+## Features
+
+- **Modular Plugin Architecture**: Centralized service locator (`Kit.registerPlugin`, `Kit.getPlugin`) with lifecycle hooks and a decoupled typed event bus (`Kit.on`, `Kit.off`).
+- **Official Plugins Included**:
+  - **`Camera` (Lens)**: 5 specialized camera types (`Follow`, `Pan`, `Spectate`, `Influence`, `Transition`), 29 shake presets, smooth zoom, zero-pop transitions, and native 2D canvas debug overlays.
+  - **`Network`**: Structured client-server packet communication with registered names and automatic indexing for bandwidth optimization.
+- **Developer CLI (`kit`)**:
+  - **`kit init`**: Interactive scaffolding for Singleplayer and Multiplayer game templates.
+  - **`kit build`**: Zero-config compilation, asset hashing (`.vyr`), metadata manifest generation, and production minification/obfuscation.
+  - **`kit host`**: Built-in local HTTP and game server hosting with hot-reloading and LAN network URLs.
+  - **`kit create`**: Instant boilerplate generator for typed plugins.
+  - **`kit doctor`**: Comprehensive environment and project health diagnostics.
+- **Smart Asset Pipeline**: Fast hashing, automatic passthrough for subdirectories, and automatic metadata manifest generation (`resource.json`, `bounds.json`, `sizes.json`, `icon-points.json`).
+- **Zero-Config TypeScript**: Powered by Bun for blazing fast bundling, incremental watch mode, and complete type safety.
+
+---
 
 ## Installation
 
 ```bash
+# Global CLI installation (recommended)
 bun install -g @evitcastudio/kit
+
+# Or as a project dependency
+bun add @evitcastudio/kit
+```
+
+---
+
+## Quickstart
+
+```bash
+# 1. Initialize a new project
+kit init my-game --single --install
+
+# 2. Build game and assets
+cd my-game && kit build
+
+# 3. Host locally
+kit host
 ```
-> **Note:** The `-g` flag ensures the `kit` CLI tool is globally available in your PATH.
+
+Your game will immediately be accessible at `http://localhost:8090` (or `http://localhost:30000` for multiplayer).
+
+---
 
 ## CLI Reference & Usage
 
-Kit includes a CLI tool (`kit`) for scaffolding projects, building game assets, generating plugin boilerplate, and diagnosing your environment.
+Kit includes the `kit` CLI for scaffolding, asset compilation, boilerplate generation, and local testing.
 
 ### Global Options
 - `-v, --verbose`: Enables verbose output and detailed debugging logs.
-- `-h, --help`: Displays help and usage information for any command.
+- `-h, --help`: Displays help and usage information.
 - `-V, --version`: Displays the installed Kit CLI version.
 
 ---
 
 ### `kit init [name]`
-Initializes a new game project for the Vylocity Game Engine. If run without arguments or flags, an interactive prompt will guide you through project setup.
+Initializes a new game project. Run without arguments for an interactive setup prompt.
 
 ```bash
 # Interactive setup
@@ -31,195 +84,224 @@ kit init
 kit init my-game --single --install
 ```
 
-#### Flags & Options:
-| Flag / Option | Type | Default | Description |
-| :--- | :--- | :--- | :--- |
-| `[name]` | `string` | `kit-project` | The name of the project folder to create. |
-| `-s, --single` | `boolean` | `false` | Quick-starts a single-player game template. |
-| `-m, --multi` | `boolean` | `false` | Quick-starts a multiplayer game template (pass both `-s` and `-m` for both). |
-| `-f, --force` | `boolean` | `false` | Overwrites the destination folder if it already exists without aborting. |
-| `-i, --install` | `boolean` | `false` | Automatically runs `bun install` inside the new project directory after creation. |
+| Option | Description | Default |
+| :--- | :--- | :--- |
+| `[name]` | Project folder name. | `kit-project` |
+| `-s, --single` | Scaffolds a single-player game template. | `false` |
+| `-m, --multi` | Scaffolds a multiplayer game template. | `false` |
+| `-f, --force` | Overwrites destination folder if it already exists. | `false` |
+| `-i, --install` | Automatically runs `bun install` after scaffolding. | `false` |
 
 ---
 
 ### `kit build`
-Builds resources and compiles game application code. Automatically detects whether your project is **Singleplayer** or **Multiplayer**, compiles TypeScript entrypoints to `dist/`, copies static web files (`.html`, `.css`, `.ico`, vendor directories), hashes raw assets into unique identifiers (`.vyr`), mirrors custom subdirectories, and exports metadata manifests (`resource.json`, `bounds.json`, `icon-points.json`, and `sizes.json`).
+Compiles TypeScript application code to `dist/`, hashes raw assets into unique identifiers (`.vyr`), mirrors asset subdirectories, and generates metadata manifests.
 
 ```bash
-# Zero-config build (auto-detects project architecture, builds ./src to ./dist)
+# Zero-config build (auto-detects project architecture)
 kit build
 
-# Production ready build (minified, obfuscated identifiers, stripped sourcemaps)
-kit build -p
-
-# Watch mode: auto-rebuilds on source or resource changes
+# Watch mode (incremental rebuilds on source or resource changes)
 kit build --watch
 
-# Build only raw resources with custom directories
-kit build -i ./src/resources -o ./dist --no-app
-
-# Save the resource manifest to a custom location
-kit build --manifest ./dist/resource.json
-```
-
-#### Flags & Options:
-| Flag / Option | Type | Required | Default | Description |
-| :--- | :--- | :--- | :--- | :--- |
-| `-i, --in <path>` | `string` | No | `./src/resources` | Input directory containing raw game assets (`.vyi`, `.vym`, `.vyint`, audio, etc.). |
-| `-o, --out <path>` | `string` | No | `./dist` | Destination directory where processed `resources/` and bundled app files will be written. |
-| `-m, --manifest <path>` | `string` | No | `./resource.json` | Path where the resource lookup JSON should be saved. If omitted, defaults to `./resource.json` in the current working directory. |
-| `-w, --watch` | `boolean` | No | `false` | Watches the source and resource directories for changes and triggers automatic incremental rebuilds. |
-| `-is, --ignore-sound` | `boolean` | No | `false` | Skips processing and copying sound and music files (`.mp3`, `.ogg`, `.wav`, etc.). |
-| `-p, --prod` | `boolean` | No | `false` | Production mode: enables full minification, identifier obfuscation/mangling, and strips sourcemaps. |
-| `--minify` | `boolean` | No | `false` | Minifies bundled JavaScript syntax, whitespace, and variable names. |
-| `--obfuscate` | `boolean` | No | `false` | Mangles and obfuscates identifiers across bundled output. |
-| `--sourcemap <mode>` | `string` | No | `linked` (`none` in prod) | Sourcemap mode (`none`, `linked`, `inline`, `external`). |
-| `--app` / `--no-app` | `boolean` | No | `true` (auto) | Toggles application code bundling. Enabled automatically if `src/index.ts` or `src/client/index.ts` exists. |
-
-#### What is the Resource Manifest (`resource.json`)?
-A manifest is an index or lookup table. `kit build` obfuscates asset names into unique identifiers (`uuid.vyr`) as a security benefit to protect and hide original asset filenames in production. It generates `resource.json` mapping your original human-readable asset names to their engine identifiers:
-```json
-{
-    "icon": [
-        {
-            "fileName": "player.vyi",
-            "resourceIdentifier": "3cf72322-6b92-4ea5-bbca-b96fae1fe440.vyr"
-        }
-    ],
-    "map": [ ... ],
-    "sound": [ ... ]
-}
-```
-
-#### Custom Asset Subdirectories (Automatic Pass-Through)
-Any subdirectories inside your resource folder (e.g. `src/resources/images`, `src/resources/fonts`, `src/resources/emitters`, `src/resources/particles`, etc.) are automatically mirrored to `<out>/resources/<folder>/`. Non-engine files remain in their original form.
-
----
-
-### `kit create <type> <name>`
-Scaffolds boilerplate files inside an existing Kit project following standard architectural conventions.
-
-```bash
-# Generate a typed plugin
-kit create plugin Inventory
+# Production build (minified, obfuscated identifiers, stripped sourcemaps)
+kit build -p
 ```
 
-#### Types:
-- `plugin`: Creates a new TypeScript file at `src/plugins/<name>.ts` that subclasses `KitPlugin` with typed lifecycle hooks (`onRegistered()`) ready to extend.
+| Option | Description | Default |
+| :--- | :--- | :--- |
+| `-i, --in <path>` | Input resource directory containing raw game assets. | `./src/resources` |
+| `-o, --out <path>` | Output directory for processed assets and bundled code. | `./dist` |
+| `-m, --manifest <path>` | Custom destination path for `resource.json`. | `./resource.json` |
+| `-w, --watch` | Watches source and resource folders for auto-rebuilding. | `false` |
+| `-p, --prod` | Production mode (minification, mangled identifiers, no maps). | `false` |
+| `--minify` / `--obfuscate` | Granular syntax minification or identifier mangling. | `false` |
+| `--sourcemap <mode>` | Sourcemap mode (`none`, `linked`, `inline`, `external`). | `linked` |
+| `--app` / `--no-app` | Toggles application code bundling. | `true` |
+
+#### Generated Metadata Manifests
+During build, Kit produces optimized metadata indices in your project:
+- **`resource.json`**: Maps original human-readable asset filenames to obfuscated engine identifiers (`uuid.vyr`).
+- **`bounds.json` & `sizes.json`**: Pre-calculated collision boundaries and dimensions for icons and tiles.
+- **`icon-points.json`**: Defined anchor points and equipment attachment coordinates for sprites.
 
 ---
 
 ### `kit host`
-Hosts the game project locally for development and testing.
+Hosts your compiled game project locally for browser or multiplayer testing.
 
 ```bash
-# Host the dist folder on port 8090
+# Host dist folder on default port 8090
 kit host
 
 # Build before hosting and specify custom port
 kit host -b -p 8080
 ```
 
-#### Options:
-- `-p, --port <number>`: Port to bind the server to (default: `8090`).
-- `-d, --dir <path>`: Directory containing built files to serve (default: `./dist`).
-- `-b, --build`: Trigger a `kit build` before starting the server.
+| Option | Description | Default |
+| :--- | :--- | :--- |
+| `-p, --port <number>` | Port to bind the server to. | `8090` |
+| `-d, --dir <path>` | Directory of built files to serve. | `./dist` |
+| `-b, --build` | Runs `kit build` prior to starting server. | `false` |
 
-#### Behavior:
-- **Singleplayer / Client Projects:** Spawns a lightweight local HTTP server powered by Bun that serves `dist/index.html` and static assets with local and network LAN URLs.
-- **Multiplayer Projects:** Automatically launches the backend node server (`dist/server.js`) with configured settings (`dist/settings.json`).
+---
+
+### `kit create <type> <name>`
+Scaffolds typed boilerplate into an existing Kit project.
+
+```bash
+kit create plugin Inventory
+```
+Generates `src/plugins/inventory.ts` subclassing `KitPlugin` with lifecycle hooks ready to extend.
 
 ---
 
 ### `kit doctor`
-Inspects your local environment and current project health.
+Inspects your local environment and project health (Bun runtime, Git availability, `package.json`, project architecture, and build pipeline).
 
 ```bash
 kit doctor
 ```
 
-#### What it checks:
-- **Bun Runtime:** Verifies that Bun is installed and detects the version.
-- **Git Installation:** Verifies that Git is accessible in your `PATH`.
-- **Project Structure:** If executed within a game project, checks `package.json`, `@evitcastudio/kit` framework dependencies, and asset folders (`src/resources`).
-- **Project Architecture:** Detects whether the project is **Singleplayer** (`src/index.ts`), **Multiplayer** (`src/client` & `src/server`), or **Dedicated Server**.
-- **Build Pipeline:** Verifies that a valid build pipeline is configured (either native `kit build` in `package.json` or legacy `bun-build.ts`).
-
 ---
 
 ## Runtime Resource Loading
 
-> **Note:** This process is preconfigured for you if you used `kit init`.
-
-`Kit.setResources()` should be called **before** `VYLO.load()`.
+`Kit.setResources()` loads the generated `resource.json` manifest into the Vylocity engine prior to calling `VYLO.load()`:
 
 ```typescript
 import resourceJSON from 'resource.json';
 
-// Initialize the engine with mapped resources
+// Initialize engine with mapped resource identifiers
 await Kit.setResources(resourceJSON);
+await VYLO.load();
 ```
 
+---
 
-## Local Development & Testing
+## Plugins
 
-Once your project is scaffolded and dependencies are installed and the project has been built, you can run your game locally.
+Kit features a modular plugin architecture. Plugins register via `Kit.registerPlugin()`, are retrievable globally through `Kit.getPlugin(name)`, and communicate across decoupled systems using Kit's typed event bus.
 
-### Running the Game
+```typescript
+import { Kit } from '@evitcastudio/kit';
+import { CustomPlugin } from 'custom-plugin';
 
-```bash
-# For Single-Player or Multiplayer games
-bun run host
+// Register with Kit
+const plugin = Kit.registerPlugin(CustomPlugin);
+
+// Retrieve anywhere by plugin name
+const plugin = Kit.getPlugin<CustomPlugin>('CustomPlugin');
+```
+
+---
+
+### Official Plugins
+
+#### 1. Camera Plugin (`Camera` / `@evitcastudio/lens`)
+High-performance 2D camera system powered by [`@evitcastudio/lens`](https://github.com/EvitcaStudio/Lens). Supports 5 specialized camera types, 29 shake presets, smooth zoom, zero-pop transitions, native canvas debug overlays, and automatic event dispatching.
+
+##### Setup & Quickstart
+
+```typescript
+import { Kit, Camera } from '@evitcastudio/kit';
+
+// 1. Register with Kit (indexes under name 'Camera')
+const camera = Kit.registerPlugin(Camera);
+
+// 2. Track player entity with smooth lerping & deadzone
+camera.createFollowCamera('main', playerMob, {
+    lerp: 0.1,
+    deadzone: { width: 64, height: 64 }
+});
 ```
 
-### Accessing the Game
+##### Seamless Transitions
+Blend smoothly between cameras or targets with Hermite spline interpolation and spring-damping (zero visual pop):
 
-The server will be available at the following locations after being hosted:
+```typescript
+await camera.switchTo(bossCamera, {
+    duration: 800,
+    smoothing: 'smoothDamp', // or 'cubicSpline'
+    springTension: 170,
+    springFriction: 26
+});
+```
 
-> **Singleplayer**  
-[http://localhost:8090](http://localhost:8090) defined in `./bun-serve.ts`
+##### Screen Shake & Zoom
+```typescript
+// Trigger built-in presets or infinite ambient shakes
+camera.shakePreset('explosion-large');
+camera.shakePreset('rumble', undefined, true);
 
-> **Multiplayer or Singleplayer & Multiplayer**  
-[http://localhost:30000](http://localhost:30000) defined in `./src/server/settings.json`
+// Smooth zoom animations with 30+ easing equations
+camera.zoom(2, 500, 'easeOutCubic');
+camera.zoom(1, 400, 'easeInOutQuad'); // Reset
+```
 
+##### Camera Event Bus
+All camera lifecycle events automatically dispatch to Kit's global event bus (`Kit.on`), allowing audio, gamepad vibration, or UI systems to decouple from camera logic:
 
-## Plugin Architecture
+```typescript
+Kit.on('Camera', 'shake-start', (event) => {
+    console.log('Camera shaking:', event.data.preset);
+});
 
-```ts
-import { Plugin } from 'custom-plugin';
+Kit.on('Camera', 'transition-start', () => {
+    // e.g. animate cinematic bars
+});
+```
+
+##### Native Debug Overlay & Gizmos
+Built-in 2D canvas overlay for debugging cameras, bounds, target vectors, and crosshairs:
 
-// Register a single plugin
-const plugin = Kit.registerPlugin(Plugin);
+```typescript
+camera.setDebugMode({
+    enabled: true,
+    showCameraMarkers: true,
+    showTargetLines: true,
+    showBounds: true,
+    showCenterCrosshair: true,
+    bounds: { minX: 0, maxX: 2000, minY: 0, maxY: 2000 }
+});
 ```
 
-```ts
-// Register multiple plugins
-import { Plugin1 } from 'custom-plugin1';
-import { Plugin2 } from 'custom-plugin2';
+---
+
+#### 2. Network Plugin (`Network`)
+Handles client-server packet communication with registered packet names, automatic indexing, and minimal bandwidth usage.
+
+```typescript
+import { Kit, Network } from '@evitcastudio/kit';
 
-const plugins = Kit.registerPlugins([Plugin1, Plugin2]);
+const network = Kit.registerPlugin(Network);
 
-// After being registered, kit can find the plugin by name.
-const plugin1 = Kit.getPlugin('plugin1-name');
-const plugin2 = Kit.getPlugin('plugin2-name');
+// Client-side: register server packet definitions & listen
+network.registerPackets(['CHAT_MESSAGE', 'PLAYER_HEAL'] as const);
+
+network.on('CHAT_MESSAGE', (client, senderName, message) => {
+    console.log(`[${senderName}]: ${message}`);
+});
 ```
 
-### Listening for plugin events
+---
 
-Plugins emit events, this is how they pass relevant data to other plugins or the main thread.
-By listening to these events you can act on this data.
+### Plugin Events
 
-```js
-const listener = (pEvent: EmitterEvent) => {
-    const { data, timestamp } = pEvent;
-    // Here you can use the data that the event sent down.
-}
+Plugins can emit and listen to events across the entire application:
 
-// Choose to listen to specific event from a plugin
-Kit.on('plugin-name', 'event-name', listener);
+```typescript
+// Listen for an event from any plugin
+Kit.on('plugin-name', 'event-name', (event) => {
+    console.log(event.data, event.timestamp);
+});
 
-// You can also stop listening for an event
+// Remove listener
 Kit.off('plugin-name', 'event-name', listener);
 ```
 
-For more information check out the [wiki](https://github.com/EvitcaStudio/Kit/wiki)
+---
+
+## License
+
+MIT © [Evitca Studio](https://evitcastudio.com) & [doubleactii](https://github.com/doubleactii)

package/lib/bundle/cli/cli.js

@@ -2,8 +2,8 @@
 // @bun
 
 /*!
- * @evitcastudio/kit@3.3.2 git+https://github.com/EvitcaStudio/Kit.git
- * Compiled Wed, 09 Sep 2026 21:02:08 UTC
+ * @evitcastudio/kit@3.5.0 git+https://github.com/EvitcaStudio/Kit.git
+ * Compiled Fri, 11 Sep 2026 04:24:00 UTC
  * Copyright (c) 2026 Jared Bates, Evitca Studio, "doubleactii"
  *
  * @evitcastudio/kit is licensed under the MIT License.
@@ -1943,7 +1943,7 @@ var {
 
 // src/cli/resource-builder.ts
 import { promises as fs2, existsSync as existsSync2 } from "fs";
-import { join as join4, extname as extname3, basename as basename3, resolve as resolve3, relative as relative3 } from "path";
+import { join as join4, extname as extname3, basename as basename3, resolve as resolve4, relative as relative3 } from "path";
 
 // node_modules/chokidar/index.js
 import { EventEmitter } from "events";
@@ -3609,17 +3609,11 @@ function v4(options, buf, offset) {
     return native_default.randomUUID();
   }
   options = options || {};
-  const rnds = options.random ?? options.rng?.() ?? rng();
-  if (rnds.length < 16) {
-    throw new Error("Random bytes length must be >= 16");
-  }
+  const rnds = options.random || (options.rng || rng)();
   rnds[6] = rnds[6] & 15 | 64;
   rnds[8] = rnds[8] & 63 | 128;
   if (buf) {
     offset = offset || 0;
-    if (offset < 0 || offset + 16 > buf.length) {
-      throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);
-    }
     for (let i = 0;i < 16; ++i) {
       buf[offset + i] = rnds[i];
     }
@@ -9143,7 +9137,7 @@ class WorkerPool {
 
 // src/cli/app-bundler.ts
 import { promises as fs, existsSync } from "fs";
-import { join as join3, dirname as dirname3, extname as extname2 } from "path";
+import { join as join3, dirname as dirname3, extname as extname2, resolve as resolve3 } from "path";
 
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -9413,12 +9407,6 @@ function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
   if (env.TERM === "xterm-kitty") {
     return 3;
   }
-  if (env.TERM === "xterm-ghostty") {
-    return 3;
-  }
-  if (env.TERM === "wezterm") {
-    return 3;
-  }
   if ("TERM_PROGRAM" in env) {
     const version = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
     switch (env.TERM_PROGRAM) {
@@ -9783,7 +9771,7 @@ async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
             name: "kit-project-resolver",
             setup(build) {
               build.onResolve({ filter: /^resource\.json$/ }, () => {
-                const resourcePath = join3(pProjectRoot, "resource.json");
+                const resourcePath = resolve3(pProjectRoot, "resource.json");
                 if (existsSync(resourcePath)) {
                   return { path: resourcePath };
                 }
@@ -9841,7 +9829,7 @@ async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
               name: "kit-project-resolver",
               setup(build) {
                 build.onResolve({ filter: /^resource\.json$/ }, () => {
-                  const resourcePath = join3(pProjectRoot, "resource.json");
+                  const resourcePath = resolve3(pProjectRoot, "resource.json");
                   if (existsSync(resourcePath)) {
                     return { path: resourcePath };
                   }
@@ -9881,7 +9869,21 @@ async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
             identifiers: shouldObfuscate,
             syntax: true,
             whitespace: true
-          } : false
+          } : false,
+          plugins: [
+            {
+              name: "kit-project-resolver",
+              setup(build) {
+                build.onResolve({ filter: /^resource\.json$/ }, () => {
+                  const resourcePath = resolve3(pProjectRoot, "resource.json");
+                  if (existsSync(resourcePath)) {
+                    return { path: resourcePath };
+                  }
+                  return;
+                });
+              }
+            }
+          ]
         });
         if (!serverResult.success) {
           console.error(serverResult.logs);
@@ -9985,7 +9987,7 @@ async function processDirectory(pDirectoryPath) {
     const contents = await fs2.readdir(pDirectoryPath);
     for (const item of contents) {
       const itemPath = join4(pDirectoryPath, item);
-      if (resolve3(itemPath) === resourceOutDirectory) {
+      if (resolve4(itemPath) === resourceOutDirectory) {
         continue;
       }
       const stats = await fs2.stat(itemPath);
@@ -10334,7 +10336,7 @@ async function runWatch() {
     try {
       const stats = await fs2.stat(pFilePath);
       if (stats.isFile()) {
-        fileStats.set(resolve3(pFilePath), { mtime: stats.mtimeMs, size: stats.size });
+        fileStats.set(resolve4(pFilePath), { mtime: stats.mtimeMs, size: stats.size });
       }
     } catch {
     }
@@ -10369,7 +10371,7 @@ async function runWatch() {
   watcher.on("all", async (event, filePath) => {
     if (event === "addDir" || event === "unlinkDir")
       return;
-    const absPath = resolve3(filePath);
+    const absPath = resolve4(filePath);
     if (event === "unlink") {
       fileStats.delete(absPath);
       const relativePath2 = relative3(projectRootDirectory, filePath).replace(/\\/g, "/");
@@ -10396,8 +10398,8 @@ async function processResources({ inDirectory, outDirectory, manifestPath, watch
   projectRootDirectory = process.cwd();
   const resolvedIn = inDirectory || (existsSync2(join4(projectRootDirectory, "src", "resources")) ? "src/resources" : "");
   const resolvedOut = outDirectory || "dist";
-  resourceInDirectory = resolvedIn ? resolve3(resolvedIn) : "";
-  resourceOutDirectory = resolvedOut ? resolve3(resolvedOut) : "";
+  resourceInDirectory = resolvedIn ? resolve4(resolvedIn) : "";
+  resourceOutDirectory = resolvedOut ? resolve4(resolvedOut) : "";
   customManifestPath = manifestPath;
   isVerbose = verbose;
   ignoringSound = ignoreSound;
@@ -11484,7 +11486,7 @@ import os2 from "os";
 // package.json
 var package_default = {
   name: "@evitcastudio/kit",
-  version: "3.3.2",
+  version: "3.5.0",
   author: "doubleactii 56242467+doubleactii@users.noreply.github.com (https://evitcastudio.com)",
   main: "./lib/index.js",
   types: "./lib/index.d.ts",
@@ -11494,6 +11496,10 @@ var package_default = {
     ".": {
       import: "./lib/index.js",
       types: "./lib/index.d.ts"
+    },
+    "./camera": {
+      import: "./lib/plugins/camera/index.js",
+      types: "./lib/plugins/camera/index.d.ts"
     }
   },
   description: "A single-player/multiplayer framework for the Vylocity Game Engine.",
@@ -11544,6 +11550,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^1.1.0",
+    "@evitcastudio/lens": "^4.3.0",
     chalk: "^5.4.0",
     chokidar: "^5.0.0",
     commander: "^12.1.0",
@@ -12030,7 +12037,7 @@ Error creating plugin: ${message}`));
 
 // src/cli/host.ts
 import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
-import { join as join7, resolve as resolve4 } from "path";
+import { join as join7, resolve as resolve5 } from "path";
 import { networkInterfaces } from "os";
 function getNetworkAddress() {
   const interfaces = networkInterfaces();
@@ -12050,7 +12057,7 @@ async function processHost(pOptions = {}) {
   const cwd = process.cwd();
   const defaultPort = 8090;
   const port = pOptions.port || defaultPort;
-  const distDir = pOptions.directory ? resolve4(pOptions.directory) : join7(cwd, "dist");
+  const distDir = pOptions.directory ? resolve5(pOptions.directory) : join7(cwd, "dist");
   const architecture = detectArchitecture(join7(cwd, "src"));
   if (!existsSync4(distDir)) {
     const message = `Target directory "${distDir}" does not exist. Run "kit build" or use "kit host -b" first.`;

package/lib/bundle/cli/kit-game-templates/multi/dist/src/client/index.js

@@ -0,0 +1,286 @@
+// node_modules/@evitcastudio/kit/lib/events/event-system.js
+class EventEmitter {
+  listener;
+  plugin;
+  constructor(pListener, pPlugin) {
+    this.listener = pListener;
+    this.plugin = pPlugin;
+  }
+  emit(pEvent) {
+    if (pEvent.plugin && pEvent.plugin !== this.plugin.name) {
+      throw new Error(`Event mismatch: ${this.plugin.name} tried to emit an event from the ${pEvent.plugin} namespace.`);
+    }
+    const event = {
+      plugin: this.plugin.name,
+      event: pEvent.event,
+      data: pEvent?.data,
+      timestamp: Date.now()
+    };
+    Object.freeze(event);
+    this.listener(event);
+  }
+}
+
+// node_modules/@evitcastudio/kit/lib/kit.js
+var extensionToPath = {
+  ".vyint": "interface",
+  ".vym": "map",
+  ".vyi": "icon",
+  ".vymac": "macros",
+  ".aac": "sound",
+  ".mp3": "sound",
+  ".wav": "sound",
+  ".m4a": "sound",
+  ".ogg": "sound",
+  ".flac": "sound"
+};
+
+class Kit {
+  static plugins = {};
+  static emitters = new Map;
+  static events = {};
+  constructor() {
+    throw new Error("[Kit] is not to be instantiated.");
+  }
+  static init(pPlugins) {
+    pPlugins.forEach((pPlugin) => {
+      this.registerPlugin(pPlugin);
+    });
+  }
+  static registerPlugin(pPlugin) {
+    if (Array.isArray(pPlugin)) {
+      const plugins = [];
+      pPlugin.forEach((pPlugin2) => {
+        const plugin = this.registerPlugin(pPlugin2);
+        if (plugin && !Array.isArray(plugin)) {
+          plugins.push(plugin);
+        }
+      });
+      return plugins;
+    } else {
+      const plugin = new pPlugin;
+      const pluginName = plugin.name;
+      if (!pluginName || typeof pluginName !== "string" || !/^[a-zA-Z0-9-_]+$/.test(pluginName)) {
+        throw new Error(`[Kit] Invalid plugin name: '${pluginName}'. The name must be a non-empty string containing only alphanumeric characters, dashes, or underscores.`);
+      }
+      if (Kit.plugins[pluginName]) {
+        throw new Error(`[Kit] plugin with name '${pluginName}' is already registered.`);
+      }
+      const listener = function(pEvent) {
+        Kit.emit(pEvent);
+      };
+      const emitter = new EventEmitter(listener, plugin);
+      Kit.emitters.set(pluginName, emitter);
+      Kit.plugins[pluginName] = plugin;
+      plugin._register(emitter);
+      plugin.onRegistered();
+      return plugin;
+    }
+  }
+  static getPlugin(pName) {
+    const plugin = Kit.plugins[pName];
+    if (!plugin) {
+      return;
+    }
+    return plugin;
+  }
+  static getPlugins() {
+    return Object.keys(Kit.plugins);
+  }
+  static emit(pEvent) {
+    const { plugin, event } = pEvent;
+    const eventScope = `${plugin}-${event}`;
+    if (!Kit.events[eventScope]) {
+      return;
+    }
+    Kit.events[eventScope].forEach((pListener) => pListener(pEvent));
+  }
+  static on(pPluginName, pEventName, pListener) {
+    const eventScope = `${pPluginName}-${pEventName}`;
+    if (!Kit.events[eventScope]) {
+      Kit.events[eventScope] = [];
+    }
+    Kit.events[eventScope].push(pListener);
+  }
+  static off(pPluginName, pEventName, pListener) {
+    const eventScope = `${pPluginName}-${pEventName}`;
+    if (Kit.events[eventScope].includes(pListener)) {
+      Kit.events[eventScope].splice(Kit.events[eventScope].indexOf(pListener), 1);
+    }
+  }
+  static setResource(pData) {
+    pData.forEach((pResource) => {
+      const extensionMatch = pResource.fileName.match(/\.[^.]+$/);
+      const fileNameWithoutExtensionMatch = pResource.fileName.match(/(.+?)(?=\.[^.]+$|$)/);
+      if (extensionMatch && fileNameWithoutExtensionMatch) {
+        const extension = extensionMatch[0];
+        const fileNameWithoutExtension = fileNameWithoutExtensionMatch[0];
+        const resourceType = extensionToPath[extension];
+        if (resourceType) {
+          globalThis.VYLO.Resource.setResource(resourceType, fileNameWithoutExtension, `${pResource.resourceIdentifier}`);
+        }
+      }
+    });
+  }
+  static async setResources(pResourceJson) {
+    if (!globalThis.VYLO) {
+      throw new Error("[Kit] VYLO is not defined. Please ensure the VYLO variable is available in the global namespace.");
+    }
+    if (pResourceJson) {
+      const resources = Object.values(pResourceJson);
+      const consolidatedData = resources.flat();
+      this.setResource(consolidatedData);
+    }
+  }
+}
+// node_modules/@evitcastudio/kit/lib/plugins/kit-plugin.js
+class KitPlugin {
+  _emitter = null;
+  _register(pEmitter) {
+    this._emitter = pEmitter;
+  }
+  emit(pEvent) {
+    if (!this._emitter) {
+      console.error("[Kit Plugin] emitter not set. This is an indication that the plugin is not registered.");
+      return;
+    }
+    this._emitter.emit(pEvent);
+  }
+}
+// node_modules/@evitcastudio/kit/lib/plugins/network/index.js
+class Network extends KitPlugin {
+  name = "Network";
+  initiated = false;
+  packets = new Map;
+  reversedPacketMap = new Map;
+  onRegistered() {
+    this.initiated = true;
+  }
+  listeners = new Map;
+  onPacket(pPacketName, pListener) {
+    if (!this.packets.has(pPacketName)) {
+      throw new Error(`Packet name '${pPacketName}' is not registered.`);
+    }
+    this.listeners.set(pPacketName, pListener);
+  }
+  on(pPacketName, pListener) {
+    this.onPacket(pPacketName, pListener);
+  }
+  onNetwork(pClient, pPacketName, pData = [], pVerbose) {
+    if (!this.initiated)
+      return;
+    if (typeof pPacketName === "number") {
+      const packetName = this.reversedPacketMap.get(pPacketName);
+      if (!packetName) {
+        if (pVerbose) {
+          console.group(`Kit.${this.name}Plugin.onNetwork`);
+          console.warn(`Unknown packet index: ${pPacketName}`);
+          console.groupEnd();
+        }
+        return;
+      }
+      const listener = this.listeners.get(packetName);
+      if (pVerbose) {
+        console.group(`Kit.${this.name}Plugin.onNetwork`);
+        if (!listener) {
+          console.warn(`No listener was registered for this packet: ${packetName}`);
+        }
+        console.log(`Packet name: ${pPacketName}`);
+        console.log(`Resolved packet name: ${packetName}`);
+        console.log(`Data:`, pData);
+        console.groupEnd();
+      }
+      listener?.(pClient, ...pData);
+    }
+  }
+  registerPackets(pPackets) {
+    this.packets.clear();
+    this.reversedPacketMap.clear();
+    pPackets.forEach((name, index) => {
+      this.packets.set(name, index);
+      this.reversedPacketMap.set(index, name);
+    });
+  }
+  getPacket(pPacketName) {
+    const packet = this.packets.get(pPacketName);
+    if (packet === undefined) {
+      console.warn(`Packet '${pPacketName}' is not registered.`);
+    }
+    return packet;
+  }
+}
+// kit-game-templates/multi/src/map-types.ts
+VYLO.setType("Tile", {
+  atlasName: "default-atlas",
+  iconName: "cobble"
+});
+VYLO.setType("Mob/Player", {
+  atlasName: "default-atlas",
+  iconName: "player"
+});
+
+// kit-game-templates/multi/src/client/packets/s-packets.ts
+var serverPackets = [
+  "SERVER_EXAMPLE1_PACKET",
+  "SERVER_EXAMPLE2_PACKET",
+  "SERVER_EXAMPLE3_PACKET"
+];
+
+// kit-game-templates/multi/src/client/c-network.ts
+Kit.registerPlugin(Network);
+var networkPlugin = Kit.getPlugin("Network");
+if (!networkPlugin) {
+  throw new Error("Network plugin not found.");
+}
+networkPlugin.registerPackets(serverPackets);
+networkPlugin.on("SERVER_EXAMPLE3_PACKET", (pClient, pData, pData2, pData3) => {
+  console.log("data", pData, pData2, pData3);
+});
+VYLO.setType("Client", {
+  onPacket(pPacketName, pData) {
+    networkPlugin?.onNetwork(this, pPacketName, pData, true);
+  }
+});
+// kit-game-templates/multi/resource.json
+var resource_default = {
+  interface: [],
+  icon: [],
+  map: [],
+  sound: [],
+  macros: []
+};
+
+// kit-game-templates/multi/src/client/index.ts
+await Kit.setResources(resource_default);
+var networkPlugin2 = Kit.getPlugin("Network");
+VYLO.setType("World", {
+  onNew() {
+    console.log("World created.");
+  },
+  onMapLoaded(pName) {
+    console.log(`'${pName}' map loaded.`);
+  }
+});
+VYLO.setType("Client", {
+  mainOutput: "",
+  maxFPS: 0,
+  hideFPS: false,
+  screenView: {
+    scaleTo: "normal",
+    scaleNearest: true,
+    disableImageSmoothing: true
+  },
+  onConnect() {
+    console.log("onConnect");
+    this.sendPacket(networkPlugin2?.getPacket("SERVER_EXAMPLE2_PACKET"), [1, 2, 3]);
+  }
+});
+VYLO.setType("Mob/Player", {
+  onLogin() {
+    console.log("onLogin");
+  },
+  onLogout() {
+    console.log("onLogout");
+  }
+});
+await VYLO.load();

package/lib/bundle/cli/kit-game-templates/multi/src/client/index.ts

@@ -1,6 +1,6 @@
 import { Kit } from '@evitcastudio/kit';
 import type { Network } from '@evitcastudio/kit';
-import '../map-types';
+import '../map-types.js';
 import './c-network';
 import resourceJSON from 'resource.json';
 

package/lib/cli/app-bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-bundler.d.ts","sourceRoot":"","sources":["../../src/cli/app-bundler.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,mBAAmB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAYvE;AA+DD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6NhI"}
+{"version":3,"file":"app-bundler.d.ts","sourceRoot":"","sources":["../../src/cli/app-bundler.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,mBAAmB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAYvE;AA+DD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2OhI"}

package/lib/cli/app-bundler.js

@@ -1,5 +1,5 @@
 import { promises as fs, existsSync } from 'node:fs';
-import { join, dirname, extname } from 'node:path';
+import { join, dirname, extname, resolve } from 'node:path';
 import chalk from 'chalk';
 import Bun from 'bun';
 import { theme } from './theme';
@@ -144,7 +144,7 @@ export async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
                         name: 'kit-project-resolver',
                         setup(build) {
                             build.onResolve({ filter: /^resource\.json$/ }, () => {
-                                const resourcePath = join(pProjectRoot, 'resource.json');
+                                const resourcePath = resolve(pProjectRoot, 'resource.json');
                                 if (existsSync(resourcePath)) {
                                     return { path: resourcePath };
                                 }
@@ -202,7 +202,7 @@ export async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
                             name: 'kit-project-resolver',
                             setup(build) {
                                 build.onResolve({ filter: /^resource\.json$/ }, () => {
-                                    const resourcePath = join(pProjectRoot, 'resource.json');
+                                    const resourcePath = resolve(pProjectRoot, 'resource.json');
                                     if (existsSync(resourcePath)) {
                                         return { path: resourcePath };
                                     }
@@ -242,7 +242,21 @@ export async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
                         identifiers: shouldObfuscate,
                         syntax: true,
                         whitespace: true
-                    } : false
+                    } : false,
+                    plugins: [
+                        {
+                            name: 'kit-project-resolver',
+                            setup(build) {
+                                build.onResolve({ filter: /^resource\.json$/ }, () => {
+                                    const resourcePath = resolve(pProjectRoot, 'resource.json');
+                                    if (existsSync(resourcePath)) {
+                                        return { path: resourcePath };
+                                    }
+                                    return undefined;
+                                });
+                            }
+                        }
+                    ]
                 });
                 if (!serverResult.success) {
                     console.error(serverResult.logs);

package/lib/events/event-system.d.ts

@@ -1,9 +1,8 @@
-import type { EmitterEvent, Listener } from '../types/shared-types';
-import type { KitPlugin } from '../plugins/kit-plugin';
+import type { EmitterEvent, Listener, KitPluginLike } from '../types/shared-types';
 export declare class EventEmitter {
     private listener;
     private plugin;
-    constructor(pListener: Listener, pPlugin: KitPlugin);
+    constructor(pListener: Listener, pPlugin: KitPluginLike);
     /**
      * Emit an event to all listeners.
      * @param pEvent - The event to emit.

package/lib/events/event-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-system.d.ts","sourceRoot":"","sources":["../../src/events/event-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAY;gBAEd,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS;IAKnD;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAcnC"}
+{"version":3,"file":"event-system.d.ts","sourceRoot":"","sources":["../../src/events/event-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAgB;gBAElB,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa;IAKvD;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAcnC"}

package/lib/index.d.ts

@@ -1,8 +1,10 @@
 export { Kit } from './kit';
 export { EventEmitter } from './events/event-system';
-export type { EmitterEvent, ResourceData, Listener, KitPluginConstructor } from './types/shared-types';
+export type { EmitterEvent, ResourceData, Listener, KitPluginLike, KitPluginConstructor } from './types/shared-types';
 export type { Client, Diob } from './types/vylo';
 export { KitPlugin } from './plugins/kit-plugin';
 export { Network } from './plugins/network';
 export type { NetworkListener } from './plugins/network';
+export { Camera, CameraPlugin, CameraManager, BaseCamera, FollowCamera, SpectateCamera, PanCamera, InfluenceCamera, TransitionCamera, GizmoRenderer } from './plugins/camera';
+export type { CameraManagerOptions, CameraDebugOptions, CameraEventName, CameraEventMap, CameraEventListener, GameInstance, Vector2D, ShakePresetConfig, ShakeOptions, EaseType, DurationSettings, EaseSettings, ShakePreset, CameraOffset, FollowCameraOptions, SpectateCameraOptions, PanCameraOptions, InfluenceCameraOptions, TransitionCameraOptions, CameraType } from './plugins/camera';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACvG,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtH,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACH,MAAM,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,aAAa,EAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACR,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACb,MAAM,kBAAkB,CAAC"}

package/lib/index.js

@@ -3,3 +3,4 @@ export { EventEmitter } from './events/event-system';
 // Plugins
 export { KitPlugin } from './plugins/kit-plugin';
 export { Network } from './plugins/network';
+export { Camera, CameraPlugin, CameraManager, BaseCamera, FollowCamera, SpectateCamera, PanCamera, InfluenceCamera, TransitionCamera, GizmoRenderer } from './plugins/camera';

package/lib/kit.d.ts

@@ -1,5 +1,5 @@
 import type { KitPlugin } from './plugins/kit-plugin';
-import type { ResourceData, Listener, KitPluginConstructor } from './types/shared-types';
+import type { ResourceData, Listener, KitPluginConstructor, KitPluginLike } from './types/shared-types';
 export declare class Kit {
     /**
      * A record of all plugins registered with the Kit class.
@@ -19,18 +19,18 @@ export declare class Kit {
      * @deprecated Use `registerPlugin` instead.
      * @param pPlugins - An array of plugins to initialize.
      */
-    static init<T extends KitPlugin>(pPlugins: KitPluginConstructor<T>[]): void;
+    static init<T = KitPluginLike>(pPlugins: KitPluginConstructor<T>[]): void;
     /**
      * Register a plugin with the Kit class.
      * @param pPlugin - The plugin to register.
      */
-    static registerPlugin<T extends KitPlugin>(pPlugin: KitPluginConstructor<T>): T;
-    static registerPlugin<T extends KitPlugin>(pPlugin: KitPluginConstructor<T>[]): T[];
+    static registerPlugin<T = KitPluginLike>(pPlugin: KitPluginConstructor<T>): T;
+    static registerPlugin<T = KitPluginLike>(pPlugin: KitPluginConstructor<T>[]): T[];
     /**
      * Gets a plugin by name.
      * @param pName - String name of the plugin to retrieve.
      */
-    static getPlugin<T extends KitPlugin>(pName: string): T | undefined;
+    static getPlugin<T = KitPlugin>(pName: string): T | undefined;
     /**
      * Lists all registered plugins.
      */

package/lib/kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAgB,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAgBvG,qBAAa,GAAG;IACZ;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO,CAAiC;IACvD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM,CAAuC;IAE5D,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI;IAM3E;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/E,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;IAsCnF;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQnE;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM,EAAE;IAI7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,IAAI;IAWlB;;;;;MAKE;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI;IAQ7E;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI;IAO9E;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAiB1B;;OAEG;WACU,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1F"}
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAgB,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAgBtH,qBAAa,GAAG;IACZ;;OAEG;IACF,OAAO,CAAC,MAAM,CAAC,OAAO,CAAqC;IAC3D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM,CAAuC;IAE5D,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,aAAa,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI;IAMzE;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,aAAa,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7E,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,aAAa,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;IA2CjF;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQ9D;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM,EAAE;IAI7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,IAAI;IAWlB;;;;;MAKE;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI;IAQ7E;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI;IAO9E;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAiB1B;;OAEG;WACU,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1F"}

package/lib/kit.js

@@ -50,7 +50,8 @@ export class Kit {
         }
         else {
             const plugin = new pPlugin();
-            const pluginName = plugin.name;
+            const pluginRecord = plugin;
+            const pluginName = pluginRecord?.name;
             if (!pluginName || typeof pluginName !== 'string' || !/^[a-zA-Z0-9-_]+$/.test(pluginName)) {
                 throw new Error(`[Kit] Invalid plugin name: '${pluginName}'. The name must be a non-empty string containing only alphanumeric characters, dashes, or underscores.`);
             }
@@ -60,11 +61,15 @@ export class Kit {
             const listener = function (pEvent) {
                 Kit.emit(pEvent);
             };
-            const emitter = new EventEmitter(listener, plugin);
+            const emitter = new EventEmitter(listener, pluginRecord);
             Kit.emitters.set(pluginName, emitter);
-            Kit.plugins[pluginName] = plugin;
-            plugin._register(emitter);
-            plugin.onRegistered();
+            Kit.plugins[pluginName] = pluginRecord;
+            if (typeof pluginRecord._register === 'function') {
+                pluginRecord._register(emitter);
+            }
+            if (typeof pluginRecord.onRegistered === 'function') {
+                pluginRecord.onRegistered();
+            }
             return plugin;
         }
     }

package/lib/plugins/camera/index.d.ts

@@ -0,0 +1,3 @@
+export { CameraPlugin, CameraPlugin as Camera, CameraManager, BaseCamera, FollowCamera, SpectateCamera, PanCamera, InfluenceCamera, TransitionCamera, GizmoRenderer } from '@evitcastudio/lens';
+export type { KitPluginEmitter, CameraManagerOptions, CameraDebugOptions, CameraEventName, CameraEventMap, CameraEventListener, GameInstance, Vector2D, ShakePresetConfig, ShakeOptions, EaseType, DurationSettings, EaseSettings, ShakePreset, CameraOffset, FollowCameraOptions, SpectateCameraOptions, PanCameraOptions, InfluenceCameraOptions, TransitionCameraOptions, CameraType } from '@evitcastudio/lens';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/camera/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/camera/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,YAAY,EACZ,YAAY,IAAI,MAAM,EACtB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,aAAa,EAChB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACR,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACb,MAAM,oBAAoB,CAAC"}

package/lib/plugins/camera/index.js

@@ -0,0 +1,2 @@
+// Re-export Camera plugin and classes directly from @evitcastudio/lens
+export { CameraPlugin, CameraPlugin as Camera, CameraManager, BaseCamera, FollowCamera, SpectateCamera, PanCamera, InfluenceCamera, TransitionCamera, GizmoRenderer } from '@evitcastudio/lens';

package/lib/plugins/kit-plugin.d.ts

@@ -8,7 +8,7 @@ export declare abstract class KitPlugin {
     /**
      * The emitter that belongs to this plugin.
      */
-    private _emitter;
+    protected _emitter: EventEmitter | null;
     /**
      * Register this plugin with the event system.
      * @param pEmitter - The emitter that belongs to this plugin.

package/lib/plugins/kit-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kit-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/kit-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,8BAAsB,SAAS;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY;IAIhC;;OAEG;IACH,QAAQ,CAAC,YAAY,IAAI,IAAI;IAE7B;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY;CAO5B"}
+{"version":3,"file":"kit-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/kit-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,8BAAsB,SAAS;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE/C;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY;IAIhC;;OAEG;IACH,QAAQ,CAAC,YAAY,IAAI,IAAI;IAE7B;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY;CAO5B"}

package/lib/types/shared-types.d.ts

@@ -1,4 +1,3 @@
-import type { KitPlugin } from '../plugins/kit-plugin';
 import type { VyloType } from './vylo.d.ts';
 /**
  * The EmitterEvent type is used to define the shape of the data that is passed to the event listeners.
@@ -19,12 +18,18 @@ type ResourceData = {
     fileName: string;
 };
 type Listener = (pData: EmitterEvent) => void;
-type KitPluginConstructor<T extends KitPlugin> = new () => T;
+interface KitPluginLike {
+    name: string;
+    onRegistered?(): void;
+    _register?(pEmitter: unknown): void;
+    [key: string]: unknown;
+}
+type KitPluginConstructor<T = KitPluginLike> = new (...args: unknown[]) => T;
 declare global {
     /**
      * The Vylocity engine.
      */
     var VYLO: VyloType;
 }
-export type { EmitterEvent, ResourceData, Listener, KitPluginConstructor };
+export type { EmitterEvent, ResourceData, Listener, KitPluginLike, KitPluginConstructor };
 //# sourceMappingURL=shared-types.d.ts.map

package/lib/types/shared-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-types.d.ts","sourceRoot":"","sources":["../../src/types/shared-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C;;GAEG;AACH,KAAK,YAAY,GAAG;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAA;AAED,KAAK,YAAY,GAAG;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACnB,CAAC;AAEF,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9C,KAAK,oBAAoB,CAAC,CAAC,SAAS,SAAS,IAAI,UAAU,CAAC,CAAC;AAC7D,OAAO,CAAC,MAAM,CAAC;IACX;;OAEG;IAEH,IAAI,IAAI,EAAE,QAAQ,CAAC;CACtB;AAED,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"shared-types.d.ts","sourceRoot":"","sources":["../../src/types/shared-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C;;GAEG;AACH,KAAK,YAAY,GAAG;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAA;AAED,KAAK,YAAY,GAAG;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACnB,CAAC;AAEF,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9C,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,SAAS,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,KAAK,oBAAoB,CAAC,CAAC,GAAG,aAAa,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7E,OAAO,CAAC,MAAM,CAAC;IACX;;OAEG;IAEH,IAAI,IAAI,EAAE,QAAQ,CAAC;CACtB;AAED,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evitcastudio/kit",
-  "version": "3.3.2",
+  "version": "3.5.0",
   "author": "doubleactii 56242467+doubleactii@users.noreply.github.com (https://evitcastudio.com)",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -10,6 +10,10 @@
     ".": {
       "import": "./lib/index.js",
       "types": "./lib/index.d.ts"
+    },
+    "./camera": {
+      "import": "./lib/plugins/camera/index.js",
+      "types": "./lib/plugins/camera/index.d.ts"
     }
   },
   "description": "A single-player/multiplayer framework for the Vylocity Game Engine.",
@@ -60,6 +64,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
+    "@evitcastudio/lens": "^4.3.0",
     "chalk": "^5.4.0",
     "chokidar": "^5.0.0",
     "commander": "^12.1.0",