@holoscript/engine 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 HoloScript Contributors
+
+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,51 @@
+# @holoscript/engine
+
+> Spatial engine powering HoloScript's 3D runtime — rendering, physics, particles, post-processing.
+
+## Overview
+
+The engine package provides the spatial computation layer for HoloScript. It bridges parsed HoloScript compositions to live 3D rendering via React Three Fiber,  WebGPU, and native platform renderers.
+
+## Key Components
+
+| Component | Purpose |
+|-----------|---------|
+| **RuntimeRenderer** | Base renderer with particle systems, PBR materials |
+| **SceneRunner** | AST walker that spawns entities and runs compositions |
+| **RuntimeBridge** | Connects SceneRunner to platform-specific renderers |
+| **HeadlessRuntime** | No-GUI execution for testing, servers, CI |
+| **ECS** | Entity-Component-System architecture |
+
+## Features
+
+- **PBR Materials** — `pbr_material`, `glass_material`, `toon_material`, `subsurface_material`
+- **Particle Systems** — Sub-emitters, color/size over lifetime, emission shapes
+- **Post-Processing** — Bloom, DOF, SSAO, color grading, motion blur, tone mapping
+- **Weather Systems** — Rain, snow, fog, time-of-day, wind
+- **Physics** — Rigidbodies, colliders, joints, force fields, articulation
+- **Navigation** — Navmesh, behavior trees, crowd management
+
+## Usage
+
+```typescript
+import { SceneRunner, HeadlessRuntime } from '@holoscript/engine';
+
+// Run a composition headlessly
+const runtime = new HeadlessRuntime();
+const runner = new SceneRunner(composition);
+await runner.run();
+
+// Access spawned entities
+console.log(runner.spawnedEntities);
+```
+
+## Related
+
+- [`@holoscript/core`](../core/) — Parsers and compilers
+- [`@holoscript/runtime`](../runtime/) — Runtime profiles
+- [`@holoscript/r3f-renderer`](../r3f-renderer/) — React Three Fiber renderer
+- [`@holoscript/spatial-engine`](../spatial-engine/) — Native spatial computation
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from '@holoscript/core';

package/dist/index.js

@@ -0,0 +1,2 @@
+// src/index.ts
+export * from "@holoscript/core";

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@holoscript/engine",
+  "version": "1.0.0",
+  "description": "HoloScript spatial engine — runtime, ECS, networking, rendering, physics",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brianonbased-dev/HoloScript.git",
+    "directory": "packages/engine"
+  },
+  "dependencies": {
+    "three": "^0.182.0",
+    "ws": "^8.16.0",
+    "@holoscript/core": "5.1.1"
+  },
+  "devDependencies": {
+    "@types/three": "^0.170.0",
+    "@types/ws": "^8.5.10",
+    "tsup": "^8.0.1",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "homepage": "https://github.com/brianonbased-dev/HoloScript#readme",
+  "bugs": {
+    "url": "https://github.com/brianonbased-dev/HoloScript/issues"
+  },
+  "author": "Brian X Base Team",
+  "keywords": [
+    "holoscript",
+    "xr",
+    "webxr",
+    "vr",
+    "ar",
+    "spatial-computing"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+/**
+ * @holoscript/engine — Spatial Runtime Engine
+ *
+ * Re-exports runtime, networking, rendering, physics, spatial, ECS from @holoscript/core.
+ * ~84K LOC combined.
+ *
+ * Usage:
+ *   import { World, Entity, System } from '@holoscript/engine';
+ */
+
+// Re-export from the core package entrypoint.
+// DTS build cannot resolve private subpath imports like '@holoscript/core/runtime'.
+export * from '@holoscript/core';

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "./dist", "rootDir": "./src", "declaration": true },
+  "include": ["src/**/*.ts"]
+}