Package Reference
HoloScript currently ships as a monorepo with 59 real packages under packages/. This section documents the public package surface and separates it from support directories that exist in the repo but are not published package manifests.
Language & Runtime Core
| Package | Purpose |
|---|---|
| @holoscript/core | Core parser, AST, validation, and compiler-facing APIs |
| @holoscript/parser | Standalone parsing and AST generation |
| @holoscript/compiler | Main compilation engine |
| @holoscript/runtime | Scene execution runtime |
| @holoscript/engine | Lower-level spatial engine systems |
| @holoscript/traits | Trait definitions and trait-oriented semantics |
| @holoscript/std | Standard library utilities and shared types |
| @holoscript/fs | Filesystem utilities for tooling and local workflows |
| @holoscript/holo-vm | VM-oriented execution runtime |
| @holoscript/wasm | WebAssembly parser and compilation surface |
| @holoscript/component | WASM Component Model packaging |
Developer Tools
| Package | Purpose |
|---|---|
| @holoscript/cli | Command-line workflows |
| @holoscript/formatter | Code formatting |
| @holoscript/linter | Static analysis |
| @holoscript/lsp | Language Server Protocol support |
| @holoscript/test | Shared testing framework |
| @holoscript/benchmark | Internal performance benchmarking |
| @holoscript/comparative-benchmarks | Cross-stack performance comparisons |
| tree-sitter-holoscript | Tree-sitter grammar for editor tooling |
Editors, Authoring, and Previews
| Package | Purpose |
|---|---|
| @holoscript/studio | Visual IDE and authoring environment |
| @holoscript/studio-bridge | Visual-to-AST synchronization layer |
| @holoscript/studio-plugin-sdk | Plugin SDK for Studio extensions |
| @holoscript/studio-desktop | Native desktop shell for Studio |
| @holoscript/vscode | VS Code extension |
| @holoscript/neovim | Neovim integration |
| @holoscript/visual | Node-based visual programming layer |
| @holoscript/playground | Browser playground |
| @holoscript/preview-component | Embeddable React preview component |
| @holoscript/video-tutorials | Programmatic tutorial video generation |
| visualizer-client | Internal preview and debugging client |
Web, SDKs, and Platform Delivery
| Package | Purpose |
|---|---|
| @holoscript/sdk | Primary JavaScript and TypeScript SDK |
| @holoscript/sdk distribution | Consolidated SDK distribution entry point |
| @holoscript/cdn | CDN-oriented browser embedding |
| @holoscript/unity-sdk | Unity integration |
| @holoscript/mcp-server | MCP tools for AI agents and IDEs |
| @holoscript/r3f-renderer | React Three Fiber renderer helpers |
AI, Agents, and Virtual Machines
| Package | Purpose |
|---|---|
| @holoscript/llm-provider | Unified model-provider interface |
| @holoscript/ai-validator | Validation for AI-generated output |
| @holoscript/agent-sdk | Agent development primitives |
| @holoscript/agent-protocol | uAA2++ lifecycle framework |
| @holoscript/intelligence | Higher-level intelligence orchestration |
| @holoscript/uaal | Universal Autonomous Agent Language VM |
| @holoscript/vm-bridge | Bridge between scene and agent VMs |
| @hololand/react-agent-sdk | React hooks and components for agent UIs |
Services, Data, and Collaboration
| Package | Purpose |
|---|---|
| @holoscript/auth | Authentication and authorization |
| @holoscript/security-sandbox | Safe execution for untrusted logic |
| @holoscript/partner-sdk | Partner API, webhooks, and analytics |
| @holoscript/registry | Registry and workspace service layer |
| @holoscript/marketplace-api | Marketplace backend APIs |
| @holoscript/marketplace-web | Marketplace web frontend |
| @holoscript/graphql-api | GraphQL service layer |
| @holoscript/adapter-postgres | PostgreSQL adapter |
| @holoscript/collab-server | Collaboration relay backend |
| @holoscript/crdt | Distributed CRDT primitives |
| @holoscript/crdt-spatial | Spatial synchronization via CRDTs |
| @holoscript/mvc-schema | Context schema for synchronized agent state |
Spatial, Animation, and Research
| Package | Purpose |
|---|---|
| @holoscript/spatial-index | Spatial indexing and lookup |
| @holoscript/animation-presets | Reusable animation configuration bundles |
| @holoscript/snn-poc | Experimental WebGPU spiking-neural prototype |
| @holoscript/snn-webgpu | Higher-throughput WebGPU spiking neural compute |
What Is Not Counted Here
The repo also contains support directories under packages/ that are useful internally but do not currently expose their own package.json. Examples include components, intellij, plugins, python-bindings, spatial-engine, and shader-preview-wgpu.
Those directories are documented separately in Support Directories, but they are not part of the current 59-package manifest count used in this reference.
Suggested Starting Points
- Start with Core, Runtime, and Compiler if you want the execution model.
- Start with SDK, Preview Component, and Playground if you want web embedding.
- Start with Agent Protocol, LLM Provider, and UAAL if you want autonomous systems.
- Start with Studio, Studio Plugin SDK, and Visual if you want authoring workflows.
- Read Support Directories if you are navigating repo-only surfaces under
packages/. - Read Governance Matrix for per-package support levels and owners.