Package Reference
HoloScript currently ships as a monorepo with 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.
Zero hardcoded stats. Verify current package counts via
find packages -maxdepth 1 -type d -name "[^.]*" | wc -land cross-check againstdocs/cross-language-deletion-ledger.md.
Language & Runtime Core
| Package | Purpose |
|---|---|
| @holoscript/core | Core parser, AST, validation, compilers, and traits |
| @holoscript/runtime | Scene execution runtime |
| @holoscript/engine | Lower-level spatial engine systems |
| @holoscript/std | Standard library utilities and shared types |
| @holoscript/holo-vm | VM-oriented execution runtime |
| @holoscript/wasm | WebAssembly parser and compilation surface |
@holoscript/parser,@holoscript/compiler, and@holoscript/traitswere merged into@holoscript/core(2026-04-29).@holoscript/fswas merged into@holoscript/std/fs. See the deletion ledger.
Developer Tools
| Package | Purpose |
|---|---|
| @holoscript/cli | Command-line workflows |
| @holoscript/formatter | Code formatting |
| @holoscript/linter | Static analysis |
| @holoscript/lsp | Language Server Protocol support |
| @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/visual | Node-based visual programming layer |
| @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/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-protocol | uAA2++ lifecycle framework |
| @holoscript/uaal | Universal Autonomous Agent Language VM |
| @hololand/react-agent-sdk | React hooks and components for agent UIs |
@holoscript/agent-sdkwas superseded by@holoscript/framework.@holoscript/intelligencewas retired. See the deletion ledger.
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/crdt | Distributed CRDT primitives |
| @holoscript/crdt-spatial | Spatial synchronization via CRDTs |
| @holoscript/mvc-schema | Context schema for synchronized agent state |
@holoscript/collab-serverwas merged into@holoscript/mcp-server(2026-04-29). See the deletion ledger.
Spatial, Animation, and Research
| Package | Purpose |
|---|---|
| @holoscript/spatial-index | Spatial indexing and lookup |
| @holoscript/animation-presets | Reusable animation configuration bundles |
| @holoscript/snn-webgpu | Higher-throughput WebGPU spiking neural compute |
@holoscript/snn-pocwas superseded by@holoscript/snn-webgpu(2026-04-29). See the deletion ledger.
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 plugins and python-bindings.
Those directories are documented separately in Support Directories, but they are not part of the current public package manifest count used in this reference. Historical packages (retired, merged, or migrated) are recorded in the Cross-Language Deletion Ledger and archived under docs/archive/packages/.
Suggested Starting Points
- Start with Core, Runtime, and Engine if you want the execution model.
- Start with SDK, Preview Component, and Studio 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.