@yagejs/debug 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @yagejs/debug
+
+FPS counter, entity inspector, and dev overlays for the [YAGE](https://yage.dev) 2D game engine.
+
+## Install
+
+```bash
+npm install @yagejs/debug
+```
+
+## Usage
+
+```ts
+import { Engine } from "@yagejs/core";
+import { DebugPlugin } from "@yagejs/debug";
+
+const engine = new Engine({ debug: true });
+engine.use(new DebugPlugin());
+```
+
+## What's in the box
+
+- **DebugPlugin** - FPS counter, entity count, and HUD overlays
+- **Debug registry** - other packages contribute widgets (physics collider overlay, input state, etc.)
+- **Manual clock mode** - deterministic frame-stepping for tests
+- **Stats store** - per-frame metrics collection
+
+### For package authors
+
+`@yagejs/debug/api` exposes hooks for other packages to register debug contributors:
+
+```ts
+import { DebugRegistryKey } from "@yagejs/debug/api";
+
+const registry = engine.context.resolve(DebugRegistryKey);
+registry.registerContributor({ /* ... */ });
+```
+
+## Docs
+
+Full documentation at [yage.dev](https://yage.dev).
+
+## License
+
+MIT

package/dist/api.cjs

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api.ts
+var api_exports = {};
+__export(api_exports, {
+  DebugRegistryKey: () => DebugRegistryKey
+});
+module.exports = __toCommonJS(api_exports);
+
+// src/types.ts
+var import_core = require("@yagejs/core");
+var DebugRegistryKey = new import_core.ServiceKey("debugRegistry");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DebugRegistryKey
+});
+//# sourceMappingURL=api.cjs.map

package/dist/api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.ts","../src/types.ts"],"sourcesContent":["export { DebugRegistryKey } from \"./types.js\";\nexport type {\n  DebugGraphics,\n  WorldDebugApi,\n  HudDebugApi,\n  StatsApi,\n  DebugContributor,\n  DebugRegistry,\n} from \"./types.js\";\n","import { ServiceKey } from \"@yagejs/core\";\n\n/**\n * Minimal subset of PixiJS Graphics used by debug drawing.\n * Avoids a runtime pixi.js dependency in the ./api subpath.\n */\nexport interface DebugGraphics {\n  position: { x: number; y: number };\n  rotation: number;\n  visible: boolean;\n  clear(): DebugGraphics;\n  rect(x: number, y: number, width: number, height: number): DebugGraphics;\n  circle(x: number, y: number, radius: number): DebugGraphics;\n  moveTo(x: number, y: number): DebugGraphics;\n  lineTo(x: number, y: number): DebugGraphics;\n  stroke(style: { width: number; color: number; alpha?: number }): DebugGraphics;\n  fill(style: { color: number; alpha?: number }): DebugGraphics;\n}\n\n/** Camera-space drawing API passed to contributors. */\nexport interface WorldDebugApi {\n  acquireGraphics(): DebugGraphics | undefined;\n  isFlagEnabled(flag: string): boolean;\n  readonly cameraZoom: number;\n}\n\n/** Screen-space HUD API passed to contributors. */\nexport interface HudDebugApi {\n  addLine(text: string): void;\n  isFlagEnabled(flag: string): boolean;\n  readonly screenWidth: number;\n  readonly screenHeight: number;\n}\n\n/** Rolling-window statistics collector. */\nexport interface StatsApi {\n  push(key: string, value: number): void;\n  average(key: string): number;\n  latest(key: string): number;\n  min(key: string): number;\n  max(key: string): number;\n}\n\n/** A debug contributor that registers drawing/sampling callbacks. */\nexport interface DebugContributor {\n  readonly name: string;\n  readonly flags: readonly string[];\n  drawWorld?(api: WorldDebugApi): void;\n  drawHud?(api: HudDebugApi): void;\n  sample?(stats: StatsApi, dt: number): void;\n  dispose?(): void;\n}\n\n/** Service interface for the debug registry. */\nexport interface DebugRegistry {\n  register(contributor: DebugContributor): void;\n  isEnabled(): boolean;\n  isFlagEnabled(contributorName: string, flag: string): boolean;\n}\n\n/** Service key for resolving the DebugRegistry via DI. */\nexport const DebugRegistryKey = new ServiceKey<DebugRegistry>(\"debugRegistry\");\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAA2B;AA6DpB,IAAM,mBAAmB,IAAI,uBAA0B,eAAe;","names":[]}

package/dist/api.d.cts

@@ -0,0 +1,68 @@
+import { ServiceKey } from '@yagejs/core';
+
+/**
+ * Minimal subset of PixiJS Graphics used by debug drawing.
+ * Avoids a runtime pixi.js dependency in the ./api subpath.
+ */
+interface DebugGraphics {
+    position: {
+        x: number;
+        y: number;
+    };
+    rotation: number;
+    visible: boolean;
+    clear(): DebugGraphics;
+    rect(x: number, y: number, width: number, height: number): DebugGraphics;
+    circle(x: number, y: number, radius: number): DebugGraphics;
+    moveTo(x: number, y: number): DebugGraphics;
+    lineTo(x: number, y: number): DebugGraphics;
+    stroke(style: {
+        width: number;
+        color: number;
+        alpha?: number;
+    }): DebugGraphics;
+    fill(style: {
+        color: number;
+        alpha?: number;
+    }): DebugGraphics;
+}
+/** Camera-space drawing API passed to contributors. */
+interface WorldDebugApi {
+    acquireGraphics(): DebugGraphics | undefined;
+    isFlagEnabled(flag: string): boolean;
+    readonly cameraZoom: number;
+}
+/** Screen-space HUD API passed to contributors. */
+interface HudDebugApi {
+    addLine(text: string): void;
+    isFlagEnabled(flag: string): boolean;
+    readonly screenWidth: number;
+    readonly screenHeight: number;
+}
+/** Rolling-window statistics collector. */
+interface StatsApi {
+    push(key: string, value: number): void;
+    average(key: string): number;
+    latest(key: string): number;
+    min(key: string): number;
+    max(key: string): number;
+}
+/** A debug contributor that registers drawing/sampling callbacks. */
+interface DebugContributor {
+    readonly name: string;
+    readonly flags: readonly string[];
+    drawWorld?(api: WorldDebugApi): void;
+    drawHud?(api: HudDebugApi): void;
+    sample?(stats: StatsApi, dt: number): void;
+    dispose?(): void;
+}
+/** Service interface for the debug registry. */
+interface DebugRegistry {
+    register(contributor: DebugContributor): void;
+    isEnabled(): boolean;
+    isFlagEnabled(contributorName: string, flag: string): boolean;
+}
+/** Service key for resolving the DebugRegistry via DI. */
+declare const DebugRegistryKey: ServiceKey<DebugRegistry>;
+
+export { type DebugContributor, type DebugGraphics, type DebugRegistry, DebugRegistryKey, type HudDebugApi, type StatsApi, type WorldDebugApi };

package/dist/api.d.ts

@@ -0,0 +1,68 @@
+import { ServiceKey } from '@yagejs/core';
+
+/**
+ * Minimal subset of PixiJS Graphics used by debug drawing.
+ * Avoids a runtime pixi.js dependency in the ./api subpath.
+ */
+interface DebugGraphics {
+    position: {
+        x: number;
+        y: number;
+    };
+    rotation: number;
+    visible: boolean;
+    clear(): DebugGraphics;
+    rect(x: number, y: number, width: number, height: number): DebugGraphics;
+    circle(x: number, y: number, radius: number): DebugGraphics;
+    moveTo(x: number, y: number): DebugGraphics;
+    lineTo(x: number, y: number): DebugGraphics;
+    stroke(style: {
+        width: number;
+        color: number;
+        alpha?: number;
+    }): DebugGraphics;
+    fill(style: {
+        color: number;
+        alpha?: number;
+    }): DebugGraphics;
+}
+/** Camera-space drawing API passed to contributors. */
+interface WorldDebugApi {
+    acquireGraphics(): DebugGraphics | undefined;
+    isFlagEnabled(flag: string): boolean;
+    readonly cameraZoom: number;
+}
+/** Screen-space HUD API passed to contributors. */
+interface HudDebugApi {
+    addLine(text: string): void;
+    isFlagEnabled(flag: string): boolean;
+    readonly screenWidth: number;
+    readonly screenHeight: number;
+}
+/** Rolling-window statistics collector. */
+interface StatsApi {
+    push(key: string, value: number): void;
+    average(key: string): number;
+    latest(key: string): number;
+    min(key: string): number;
+    max(key: string): number;
+}
+/** A debug contributor that registers drawing/sampling callbacks. */
+interface DebugContributor {
+    readonly name: string;
+    readonly flags: readonly string[];
+    drawWorld?(api: WorldDebugApi): void;
+    drawHud?(api: HudDebugApi): void;
+    sample?(stats: StatsApi, dt: number): void;
+    dispose?(): void;
+}
+/** Service interface for the debug registry. */
+interface DebugRegistry {
+    register(contributor: DebugContributor): void;
+    isEnabled(): boolean;
+    isFlagEnabled(contributorName: string, flag: string): boolean;
+}
+/** Service key for resolving the DebugRegistry via DI. */
+declare const DebugRegistryKey: ServiceKey<DebugRegistry>;
+
+export { type DebugContributor, type DebugGraphics, type DebugRegistry, DebugRegistryKey, type HudDebugApi, type StatsApi, type WorldDebugApi };

package/dist/api.js

@@ -0,0 +1,7 @@
+import {
+  DebugRegistryKey
+} from "./chunk-QSE3OVXA.js";
+export {
+  DebugRegistryKey
+};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-QSE3OVXA.js

@@ -0,0 +1,12 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/types.ts
+import { ServiceKey } from "@yagejs/core";
+var DebugRegistryKey = new ServiceKey("debugRegistry");
+
+export {
+  __name,
+  DebugRegistryKey
+};
+//# sourceMappingURL=chunk-QSE3OVXA.js.map

package/dist/chunk-QSE3OVXA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { ServiceKey } from \"@yagejs/core\";\n\n/**\n * Minimal subset of PixiJS Graphics used by debug drawing.\n * Avoids a runtime pixi.js dependency in the ./api subpath.\n */\nexport interface DebugGraphics {\n  position: { x: number; y: number };\n  rotation: number;\n  visible: boolean;\n  clear(): DebugGraphics;\n  rect(x: number, y: number, width: number, height: number): DebugGraphics;\n  circle(x: number, y: number, radius: number): DebugGraphics;\n  moveTo(x: number, y: number): DebugGraphics;\n  lineTo(x: number, y: number): DebugGraphics;\n  stroke(style: { width: number; color: number; alpha?: number }): DebugGraphics;\n  fill(style: { color: number; alpha?: number }): DebugGraphics;\n}\n\n/** Camera-space drawing API passed to contributors. */\nexport interface WorldDebugApi {\n  acquireGraphics(): DebugGraphics | undefined;\n  isFlagEnabled(flag: string): boolean;\n  readonly cameraZoom: number;\n}\n\n/** Screen-space HUD API passed to contributors. */\nexport interface HudDebugApi {\n  addLine(text: string): void;\n  isFlagEnabled(flag: string): boolean;\n  readonly screenWidth: number;\n  readonly screenHeight: number;\n}\n\n/** Rolling-window statistics collector. */\nexport interface StatsApi {\n  push(key: string, value: number): void;\n  average(key: string): number;\n  latest(key: string): number;\n  min(key: string): number;\n  max(key: string): number;\n}\n\n/** A debug contributor that registers drawing/sampling callbacks. */\nexport interface DebugContributor {\n  readonly name: string;\n  readonly flags: readonly string[];\n  drawWorld?(api: WorldDebugApi): void;\n  drawHud?(api: HudDebugApi): void;\n  sample?(stats: StatsApi, dt: number): void;\n  dispose?(): void;\n}\n\n/** Service interface for the debug registry. */\nexport interface DebugRegistry {\n  register(contributor: DebugContributor): void;\n  isEnabled(): boolean;\n  isFlagEnabled(contributorName: string, flag: string): boolean;\n}\n\n/** Service key for resolving the DebugRegistry via DI. */\nexport const DebugRegistryKey = new ServiceKey<DebugRegistry>(\"debugRegistry\");\n"],"mappings":";;;;AAAA,SAAS,kBAAkB;AA6DpB,IAAM,mBAAmB,IAAI,WAA0B,eAAe;","names":[]}