@forgeax/engine-devkit 0.0.0-dev.8d955ade1c79

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+import type { GameProjectPluginEntry } from '@forgeax/engine-project';
+export type ForgeaXCommand = 'new' | 'init' | 'doctor' | 'test' | 'dev' | 'build' | 'package' | 'capture' | 'serve' | 'preview' | 'plugin.install' | 'plugin.uninstall' | 'skill.install' | 'skill.verify' | 'sdk.install' | 'asset.add' | 'asset.verify' | 'asset.inspect' | 'asset.list' | 'shader.check' | 'list' | 'describe' | 'run' | 'exec';
+export interface CommandError {
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<Record<string, unknown>>;
+}
+export type CommandResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: CommandError;
+};
+export interface CommandEnvelope<T = unknown> {
+    readonly schemaVersion: '1.0.0';
+    readonly command: ForgeaXCommand;
+    readonly ok: boolean;
+    readonly value?: T;
+    readonly error?: CommandError;
+}
+export interface ProjectFacts {
+    readonly root: string;
+    readonly id: string;
+    readonly name: string;
+    readonly entry: string;
+    readonly bootstrapEntry?: string;
+    readonly plugins: readonly GameProjectPluginEntry[];
+    readonly physics?: '2d' | '3d';
+    readonly defaultScene?: string;
+    readonly assetRoots: readonly string[];
+    readonly assetImporters?: readonly string[];
+    readonly assetPublicDir?: string;
+    readonly packageJson: Readonly<Record<string, unknown>>;
+}
+export interface ProjectCommandOptions {
+    readonly root?: string;
+    readonly json?: boolean;
+    readonly port?: number;
+}
+export interface ProjectPortOptions {
+    readonly port: number;
+    readonly strictPort: boolean;
+}
+export declare function parseProjectPortOption(value: string | undefined, provided: boolean): CommandResult<number | undefined>;
+export declare function resolveProjectPort(port: number | undefined): ProjectPortOptions;
+export interface InitOptions extends ProjectCommandOptions {
+    readonly dryRun?: boolean;
+    readonly install?: boolean;
+}
+export interface NewOptions extends ProjectCommandOptions {
+    readonly dryRun?: boolean;
+    readonly template?: string;
+}
+export interface BuildOptions extends ProjectCommandOptions {
+    readonly base?: string;
+    readonly outDir?: string;
+}
+export interface PackageOptions extends ProjectCommandOptions {
+    readonly output?: string;
+}
+export interface SoftwareCaptureOptions extends ProjectCommandOptions {
+    readonly software: true;
+    readonly output?: string;
+    readonly browser?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly waitMs?: number;
+    readonly requireUi?: boolean;
+    readonly deterministic?: boolean;
+}
+export interface AssetAddOptions extends ProjectCommandOptions {
+    readonly path: string;
+    readonly dryRun?: boolean;
+}
+export interface AssetInspectOptions extends ProjectCommandOptions {
+    readonly subject: string;
+}
+export interface ShaderCheckOptions extends ProjectCommandOptions {
+    readonly path?: string;
+}
+export interface OperationCommandOptions extends ProjectCommandOptions {
+    readonly id?: string;
+    readonly args?: string;
+    readonly input?: string;
+    readonly program?: string;
+}
+export interface PluginInstallOptions extends ProjectCommandOptions {
+    readonly id: string;
+    readonly module: string;
+    readonly realm?: 'host' | 'engine' | 'build';
+    readonly dependency?: string;
+    readonly dryRun?: boolean;
+}
+export interface PluginUninstallOptions extends ProjectCommandOptions {
+    readonly id: string;
+    readonly dependency?: string;
+    readonly dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@forgeax/engine-devkit",
+  "version": "0.0.0-dev.8d955ade1c79",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "ForgeaX external game project CLI and build orchestration.",
+  "bin": {
+    "forgeax": "./dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./cli": "./dist/cli.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@forgeax/engine-animation": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-app": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-assets-runtime": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-audio": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-audio-webaudio": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-fbx": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-font": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-gltf": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-image": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-input": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-pack": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-physics": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-plugin": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-preview": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-project": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-render": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-render-graph": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-rhi-debug": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-rhi-null": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-rhi-webgpu": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-runtime": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-scene": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-shader-compiler": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-skinning": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-tool-runtime": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-types": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-vfx-compiler": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-vite-plugin-pack": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-vite-plugin-shader": "0.0.0-dev.8d955ade1c79",
+    "jiti": "1.21.7",
+    "playwright": "1.60.0",
+    "vite": "8.0.10",
+    "vitest": "4.1.5",
+    "webgpu": "^0.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0"
+  },
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/cli.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "Node-only build orchestration; runtime FPS belongs to consumer games"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "CLI latency is not a runtime hot path"
+      },
+      "gate": {
+        "enabled": true,
+        "command": "pnpm test",
+        "cwd": "packages/devkit"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "production DevKit package"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  }
+}