open-index/open-npm huggingface dataset:
npm package: @holonym-foundation/off-chain-sdk
Description: An SDK for verifying off-chain proofs from Holonym users.
Latest version: 0.0.6

# @holonym-foundation/off-chain-sdk

An SDK for verifying off-chain proofs from Holonym users.

## Installation

```bash
npm i @holonym-foundation/off-chain-sdk
```

## Usage

See [Holonym's docs for off-chain proofs](https://docs.holonym.id/for-developers/off-chain-proofs) for more information on how to get proofs from users.

```typescript
import { verifyUniquenessProof } from "@holonym-foundation/off-chain-sdk";
import type { Proof } from "@holonym-foundation/off-chain-sdk";

async function verify(proof: Proof): Promise<boolean> {
  const result = await verifyUniquenessProof(proof);
  console.log(`User is unique: ${result}`);
  return result;
}
```
npm package: @holores/holoapi
Description: A Javascript library for the Holotools API.
Author: Hololive Resort website team
Latest version: 1.0.6
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

# Holotools API client
[![NPM](https://nodeico.herokuapp.com/@holores/holoapi.svg)](https://npmjs.com/package/@holores/holoapi)

A client for Javascript to interact with the [HoloAPI](https://api.holotools.app/v1/api-docs) from [HoloFans](https://github.com/holofans/holoapi).

Documentation can be found [here](https://holores.github.io/holotools-api/modules/index.html).

This project was intended for me to learn how to work with the NPM registry, Typescript and mocha + chai.
npm package: @holores/holodex
Description: A Typescript library for the Holodex API.
Author: Ninjastahr
Latest version: 1.2.4

# Holodex API client

[![NPM](https://nodeico.herokuapp.com/@holores/holodex.svg)](https://npmjs.com/package/@holores/holodex)

A client for Javascript to interact with the [API](https://holodex.stoplight.io/) from [HoloDex](https://holodex.net).

Documentation can be found [here](https://holores.github.io/holodex-api/modules/index.html).
npm package: @holoscript/alphafold-plugin
Description: AlphaFold protein structure prediction for HoloScript - Generate novel proteins in VR
Author: HoloScript Contributors
Latest version: 1.0.0

# @holoscript/alphafold-plugin

**AlphaFold protein structure prediction for HoloScript** - Generate novel proteins in VR

[![npm version](https://img.shields.io/npm/v/@holoscript/alphafold-plugin.svg)](https://www.npmjs.com/package/@holoscript/alphafold-plugin)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- 🧬 **AlphaFold3 API Integration** - Cloud-based protein structure prediction
- 🔬 **Local ColabFold Support** - Run predictions on your own GPU
- 🎨 **pLDDT Confidence Coloring** - Visualize prediction confidence in VR
- 🧪 **Multimer Prediction** - Predict protein complexes (antibodies, etc.)
- 📊 **PAE Visualization** - Predicted Aligned Error heatmaps
- ⚡ **Batch Predictions** - Compare multiple protein variants

## Installation

```bash
npm install holoscript @holoscript/alphafold-plugin
pip install requests  # Python dependency
```

## Quick Start

```holoscript
object "My Protein" @alphafold_predict @structure_confidence {
  sequence: "MKTAYIAKQRQISFVKSHFSRQLEERLGLIEVQAPILSRVGDGTQDNLSGAEKAVQVKVK",
  mode: "api",
  color_by: "confidence",
}
```

## Documentation

See [examples/protein-prediction.holo](examples/protein-prediction.holo) for comprehensive examples.

## Requirements

- **Node.js**: 18.0.0+
- **Python**: 3.10+
- **AlphaFold3 API Key** (for API mode) or **ColabFold** (for local mode)

## License

MIT © HoloScript Contributors

---

**Generated by**: [create-holoscript-plugin](https://www.npmjs.com/package/create-holoscript-plugin)
npm package: @holoscript/animation-presets
Description: Pre-configured @animated trait parameter sets for common character behaviors with Mixamo clip mapping
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/animation-presets

> Pre-configured `@animated` trait parameter sets for common character behaviors with Mixamo clip mapping.

## Overview

Provides ready-to-use animation preset configurations for the `@animated` trait. Each preset maps to standard Mixamo clips and can be applied to any humanoid character.

## Usage

```holo
object "Guard" {
  @animated { preset: "idle_guard" }
}
```

```typescript
import { getAnimationPreset, listPresets } from '@holoscript/animation-presets';

const preset = getAnimationPreset('idle_guard');
// → { clips: ['Idle', 'LookAround'], blend: 0.3, loop: true }

const all = listPresets();
// → ['idle_guard', 'walk_patrol', 'run_chase', 'attack_melee', ...]
```

## Presets

| Preset | Clips | Use Case |
|--------|-------|----------|
| `idle_guard` | Idle, LookAround | Stationary NPC |
| `walk_patrol` | Walk, Turn | Patrol routes |
| `run_chase` | Run, Sprint | Pursuit behavior |
| `attack_melee` | Slash, Stab | Combat |
| `dance_casual` | Dance, Sway | Social VR |

## Related

- [`@holoscript/core` traits](../core/) — Base `@animated` trait
- [Mixamo](https://www.mixamo.com/) — Source animation clips

## License

MIT
npm package: @holoscript/auth
Description: Shared JWT authentication library for HoloScript APIs (GraphQL + Marketplace)
Author: Brian X Base Team
Latest version: 6.0.0

# @holoscript/auth

> Shared JWT authentication library for HoloScript APIs (GraphQL + Marketplace).

## Overview

Provides JWT-based authentication middleware and utilities shared across HoloScript API services including the GraphQL API and Marketplace.

## Usage

```typescript
import { verifyToken, createToken, authMiddleware } from '@holoscript/auth';

// Create a JWT
const token = createToken({ userId: 'user-123', role: 'developer' });

// Verify a JWT
const payload = verifyToken(token);

// Express middleware
app.use('/api', authMiddleware());
```

## Configuration

Set via environment variables:

```bash
SECURITY_JWT_SECRET=your-secret-key
SECURITY_JWT_EXPIRES_IN=24h
SECURITY_BCRYPT_ROUNDS=10
```

## Related

- [`@holoscript/graphql-api`](../graphql-api/) — GraphQL API using this auth
- [`@holoscript/marketplace-api`](../marketplace-api/) — Marketplace API

## License

MIT
npm package: @holoscript/cdn
Description: Browser CDN distribution for HoloScript — embed spatial scenes with <holo-scene>
Author: HoloScript Team
Latest version: 1.0.0

# @holoscript/cdn

Browser CDN distribution for HoloScript. Embed spatial scenes in web pages using the `<holo-scene>` web component.

## Usage

```bash
pnpm install
pnpm build
```

Include the built bundle in a web page to register the `<holo-scene>` custom element.

## Development

```bash
pnpm dev      # Build with watch mode (tsup)
pnpm test     # Run tests (vitest)
```
npm package: @holoscript/cli
Description: Command-line interface for HoloScript — compile, validate, dev-serve, and analyze .holo files
Author: Brian X Base Team
Latest version: 6.0.3

# @holoscript/cli

Command-line interface for HoloScript development.

## Installation

```bash
npm install -g @holoscript/cli
```

## Commands

### Build / Compile

Compile HoloScript files to target platforms:

```bash
holoscript build src/
holoscript build --target web --output dist/
holoscript compile scene.holo --target unity
```

### Parse & Validate

```bash
holoscript parse scene.holo
holoscript validate src/
holoscript ast scene.holo          # Show AST output
```

### Run & Dev

```bash
holoscript run scene.holo          # Execute headless
holoscript repl                    # Interactive shell
holoscript watch src/              # Watch for changes
holoscript headless scene.holo     # Headless runtime
```

### Package Management

```bash
holoscript add @holoscript/std
holoscript remove @holoscript/std
holoscript list                    # List installed packages
holoscript pack                    # Package assets
holoscript unpack bundle.hsa       # Unpack assets
```

### Registry & Publishing

```bash
holoscript publish                 # Publish package
holoscript login                   # Authenticate
holoscript logout                  # Sign out
holoscript whoami                  # Show identity
holoscript access grant user pkg   # Manage access
holoscript org create my-team      # Organization management
holoscript token create            # Token management
```

### Code Tools

```bash
holoscript traits                  # List available traits
holoscript suggest scene.holo      # Get code suggestions
holoscript generate "a VR lobby"   # AI code generation
holoscript templates               # Show available templates
holoscript inspect output.js       # Inspect compiled output
holoscript diff a.holo b.holo      # Show differences
```

### Deployment

```bash
holoscript deploy scene.holo       # Deploy to remote
holoscript monitor                 # Monitor runtime
holoscript wot-export scene.holo   # W3C Web of Things export
```

## Configuration

Create `holoscript.config.json`:

```json
{
  "$schema": "https://holoscript.net/schemas/config.v3.json",
  "version": 3,
  "compiler": {
    "target": "web",
    "strict": true
  }
}
```

## License

MIT
npm package: @holoscript/compiler
Description: HoloScript compiler — 25 compile targets (Unity, Unreal, Godot, VisionOS, WASM, WebGPU, USD, glTF, etc.)
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/compiler

> Standalone HoloScript compiler — `.hsplus` to platform-specific code.

## Overview

The compiler package provides standalone compilation from HoloScript source to platform-specific output. It wraps the compiler infrastructure from `@holoscript/core` into a focused, importable API.

## Supported Targets

| Target | Platform | Output |
|--------|----------|--------|
| `unity` | Unity Engine | C# scripts |
| `unreal` | Unreal Engine 5 | C++ / Blueprints |
| `godot` | Godot 4 | GDScript |
| `r3f` | React Three Fiber | JSX components |
| `babylon` | Babylon.js | TypeScript |
| `visionos` | Apple Vision Pro | Swift / RealityKit |
| `webgpu` | WebGPU | WGSL shaders |
| `wasm` | WebAssembly | WAT / binary |
| `openxr` | OpenXR | C++ / Khronos |
| `android-xr` | Android XR | Kotlin |
| `ios` | iOS / ARKit | Swift |
| `android` | Android / ARCore | Kotlin |
| `vrchat` | VRChat | Udon# |
| `urdf` | Robotics | URDF XML |
| `sdf` | Robotics | SDF XML |
| `dtdl` | Digital Twins | DTDL JSON |
| `usd` | Universal Scene | USD |
| `gltf` | 3D Interchange | glTF JSON |

## Usage

```typescript
import { compile } from '@holoscript/compiler';

const output = await compile('./scene.holo', { target: 'unity' });
```

## CLI

```bash
holoscript compile scene.holo --target unity --output ./build/
holoscript compile agent.hsplus --target node --output ./dist/
```

## Adding a New Compiler Target

See [Contributing a New Compiler](../../docs/guides/contributing-new-compiler.md).

## Related

- [`@holoscript/core`](../core/) — Core compiler classes
- [`@holoscript/compiler-wasm`](../compiler-wasm/) — WASM-compiled compiler for browsers

## License

MIT
npm package: @holoscript/compiler-utils
Description: Shared compiler utilities — domain block compilation (materials, physics, particles, post-fx, audio, weather) and target-specific codegen helpers
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/compiler-utils

Shared compiler utilities for the HoloScript ecosystem.

## What's Inside

Domain block compilation functions used by 17+ compile targets:

- **Materials**: `compileMaterialBlock`, `materialToR3F`, `materialToUSD`, `materialToGLTF`, `materialToUnity`
- **Physics**: `compilePhysicsBlock`, `physicsToURDF`, `physicsToUnity`
- **Particles**: `compileParticleBlock`, `particlesToR3F`, `particlesToUnity`
- **Post-FX**: `compilePostProcessingBlock`, `postProcessingToR3F`
- **Audio**: `compileAudioSourceBlock`, `audioSourceToR3F`
- **Weather**: `compileWeatherBlock`, `weatherToUSD`

## Usage

```typescript
import { compileMaterialBlock, materialToR3F } from '@holoscript/compiler-utils';

const mat = compileMaterialBlock(domainBlock);
const jsx = materialToR3F(mat);
```

## Dependencies

Requires `@holoscript/core` (workspace dependency).
npm package: @holoscript/connector-core
Description: Foundational abstract interfaces and MCP Registrar for the Studio Integration Hub
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/connector-core

> Foundational abstract interfaces and MCP Registrar for the Studio Integration Hub.

## Overview

Provides the base abstractions for all HoloScript Studio connectors (GitHub, Railway, Upstash, App Store). Each connector extends the abstract interfaces defined here and registers with the MCP Registrar.

## Key Components

| Component | Purpose |
|-----------|---------|
| `McpRegistrar` | Central MCP tool registration for all connectors |
| `ConnectorInterface` | Abstract base for all connector implementations |
| `ConnectorConfig` | Shared configuration types |

## Usage

```typescript
import { McpRegistrar, ConnectorInterface } from '@holoscript/connector-core';

// Register a connector's tools with the MCP server
const registrar = new McpRegistrar(mcpServer);
registrar.register(myConnector);
```

### Implementing a Connector

```typescript
import { ConnectorInterface } from '@holoscript/connector-core';

export class MyConnector extends ConnectorInterface {
  name = 'my-service';
  
  getTools() {
    return [
      { name: 'my_tool', description: '...', handler: this.handleTool },
    ];
  }
}
```

## Existing Connectors

| Connector | Package | Service |
|-----------|---------|---------|
| GitHub | `@holoscript/connector-github` | Repository management |
| Railway | `@holoscript/connector-railway` | Deployment |
| Upstash | `@holoscript/connector-upstash` | Redis/Kafka |
| App Store | `@holoscript/connector-appstore` | Plugin distribution |

## Related

- [MCP Server Guide](../../docs/guides/mcp-server.md)
- [Studio Integration Hub](../../docs/guides/studio-repo-management.md)

## License

MIT
npm package: @holoscript/crdt-spatial
Description: Loro CRDT-based spatial transform synchronization with Strategy C hybrid rotation handling (base quaternion LWW + delta Euler counters + 30s checkpoint)
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/crdt-spatial

> Loro CRDT-based spatial transform synchronization with hybrid rotation handling.

## Overview

Provides conflict-free replicated data types (CRDTs) specialized for spatial transforms in multiplayer HoloScript scenes. Uses [Loro](https://loro.dev/) as the CRDT backend with a hybrid rotation strategy.

## Strategy C: Hybrid Rotation Handling

| Component | Strategy | Why |
|-----------|----------|-----|
| Position | Last-Writer-Wins (LWW) | Simple, low-frequency |
| Scale | Last-Writer-Wins (LWW) | Rarely conflicting |
| Rotation | Hybrid | Quaternions don't merge well |

**Rotation hybrid approach:**
- **Base quaternion**: LWW for absolute orientation
- **Delta Euler counters**: CRDT counters for incremental turns
- **30s checkpoint**: Periodic full-state sync to prevent drift

## Usage

```typescript
import { SpatialCRDT } from '@holoscript/crdt-spatial';

const sync = new SpatialCRDT({ checkpointInterval: 30000 });

// Apply local transform
sync.setPosition(entity, [1, 2, 3]);
sync.addRotation(entity, { yaw: 45 });

// Merge remote state
sync.merge(remoteState);
```

## Related

- [`@holoscript/crdt`](../crdt/) — Base CRDT primitives
- [Multiplayer example](../../examples/specialized/multiplayer/)

## License

MIT
npm package: @holoscript/holo-vm
Description: HOLO VM — HoloScript native bytecode execution engine for spatial computing
Author: Brian X Base Team
Latest version: 6.0.3

# @holoscript/holo-vm

**HOLO VM** — HoloScript's native bytecode execution engine for spatial computing.

Compile `.holo` / `.hsplus` / `.hs` → `.holob` bytecode → run anywhere.

## Quick Start

```ts
import { HoloBytecodeBuilder, HoloVM, GeometryType } from '@holoscript/holo-vm';

const builder = new HoloBytecodeBuilder();
builder.addEntity('MyCube', 0);

const main = builder.addFunction('main');
main.setGeometry(1, GeometryType.Cube).transform(1, 0, 2, -5).halt();

const vm = new HoloVM();
vm.load(builder.build());
const result = vm.tick(16.67);
// result.entityCount = 1, result.status = 'HALTED'
```

## Architecture

- **ECS World** — Entity/Component storage with archetype queries
- **Stack VM** — Operand stack + registers + call stack
- **8 Opcode Families** — Entity, Spatial, Physics, Rendering, Trait, I/O, Control, Agent Bridge
- **`.holob` bytecode** — Compact binary format with string/asset/trait/code/event sections
- **90fps tick loop** — Designed for VR render loops with YIELD support
- **Double-buffered** — Dirty-flag system for minimal render updates

## Scripts

```bash
npm run test    # Run tests
npm run build   # Build to dist/
npm run dev     # Watch mode
```
npm package: @holoscript/intelligence
Description: HoloScript AI intelligence — agents, swarm, training, self-improvement
Author: Brian X Base Team
Latest version: 1.1.0

# @holoscript/intelligence

> AI intelligence layer — agents, swarm coordination, training, and self-improvement.

## Overview

The intelligence package provides higher-level AI capabilities built on top of `@holoscript/core`, including swarm coordination, training data management, and autonomous self-improvement pipelines.

## Key Components

| Component | Purpose |
|-----------|---------|
| **AgentIntelligence** | AI decision-making for spatial agents |
| **SwarmCoordinator** | Multi-agent swarm behaviors and coordination |
| **TrainingPipeline** | Training data collection and curriculum management |
| **SelfImproveEngine** | Autonomous code evolution and optimization |

## Usage

```typescript
import { SwarmCoordinator, AgentIntelligence } from '@holoscript/intelligence';

const swarm = new SwarmCoordinator({
  agents: ['guard-1', 'guard-2', 'guard-3'],
  strategy: 'formation',
});

await swarm.coordinate('patrol', { zone: 'TreasureRoom' });
```

## Related

- [`@holoscript/core`](../core/) — Core agent types and registries
- [`@holoscript/agent-sdk`](../agent-sdk/) — Public agent SDK
- [`@holoscript/llm-provider`](../llm-provider/) — LLM adapter layer

## License

MIT
npm package: @holoscript/llm-provider
Description: Unified LLM provider SDK for HoloScript - OpenAI, Anthropic, and Gemini adapters
Author: Brian X Base Team
Latest version: 1.2.0

# @holoscript/llm-provider

Unified LLM provider SDK for HoloScript with adapters for OpenAI, Anthropic, and Gemini.

## Usage

```bash
pnpm install
```

```ts
import { createProvider } from '@holoscript/llm-provider';
import { OpenAIAdapter } from '@holoscript/llm-provider/adapters/openai';
```

Install the provider SDK you need as a peer dependency (`openai` or `@anthropic-ai/sdk`).

## Development

```bash
pnpm dev            # Build with watch mode (tsup)
pnpm test           # Run tests (vitest)
pnpm test:coverage  # Run tests with coverage
```
npm package: @holoscript/lsp
Description: Language Server Protocol implementation for HoloScript
Author: Brian X Base Team
Latest version: 6.0.3

# @holoscript/lsp

Language Server Protocol implementation for HoloScript.

## Installation

```bash
npm install @holoscript/lsp
```

## Features

- 🎯 **Autocomplete** - Intelligent code completion
- 🔍 **Hover** - Documentation on hover
- 📍 **Go to Definition** - Navigate to declarations
- 🔎 **Find References** - Find all usages
- ✏️ **Rename** - Safe symbol renaming
- 🔧 **Code Actions** - Quick fixes and refactors
- 🎨 **Semantic Highlighting** - Rich syntax coloring
- ⚠️ **Diagnostics** - Real-time error reporting

## Usage

### As a Server

```typescript
import { startServer } from '@holoscript/lsp';

startServer({
  connection: createConnection(),
  documents: new TextDocuments(TextDocument),
});
```

### With VS Code

The LSP is bundled with [@holoscript/vscode](https://marketplace.visualstudio.com/items?itemName=holoscript.holoscript-vscode).

### With Neovim

```lua
require('lspconfig').holoscript.setup({
  cmd = { 'holoscript-lsp', '--stdio' },
})
```

## AI Autocomplete

Enable AI-powered suggestions:

```typescript
import { createAutocomplete } from '@holoscript/lsp';

const autocomplete = createAutocomplete({
  provider: 'copilot',
  context: 'vr-game',
});
```

## License

MIT
npm package: @holoscript/marketplace-api
Description: HoloScript Trait Marketplace API - publishing, discovery, and dependency resolution
Author: HoloScript Team
Latest version: 1.2.2

# @holoscript/marketplace-api

REST API for the HoloScript Trait Marketplace - publishing, discovery, and dependency resolution for community traits and packages.

## Features

- **Trait Publishing** - Publish custom traits with versioning (semver)
- **Discovery** - Search and browse community traits by category, tag, or keyword
- **Dependency Resolution** - Automatic dependency graph resolution for trait packages
- **Rate Limiting** - Built-in rate limiting via `rate-limiter-flexible`
- **Validation** - Zod-based request validation

## Tech Stack

| Component  | Technology                  |
| ---------- | --------------------------- |
| Server     | Express 4                   |
| Validation | Zod                         |
| Database   | PostgreSQL (pg)             |
| Cache      | Redis                       |
| Logging    | Winston                     |
| Security   | Helmet, CORS, rate limiting |

## Installation

```bash
pnpm install
```

## Development

```bash
pnpm dev    # Start with hot reload (tsx watch)
pnpm build  # Compile TypeScript
pnpm start  # Run compiled output
pnpm test   # Run tests
```

## Dependencies

- `@holoscript/core` - Parser and trait definitions
- `@holoscript/registry` - Package registry client

## License

MIT
npm package: @holoscript/parser
Description: HoloScript parser — tree-sitter grammars, tokenizer, AST types. Rust/WASM candidate.
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/parser

> HoloScript parser — tree-sitter grammars, tokenizer, AST types. Rust/WASM candidate.

## Overview

Standalone parser package providing tree-sitter grammars and a performant tokenizer for HoloScript's three file formats (`.holo`, `.hs`, `.hsplus`). Designed as a Rust/WASM compilation candidate for use in browsers and editors.

## Key Components

| Component | Purpose |
|-----------|---------|
| **Tokenizer** | Lexical analysis for all HoloScript formats |
| **Tree-sitter grammar** | Incremental parsing for editor integration |
| **AST Types** | TypeScript type definitions for the AST |

## Usage

```typescript
import { tokenize, parse } from '@holoscript/parser';

// Tokenize source
const tokens = tokenize(source);

// Parse to AST
const ast = parse(source, { format: 'holo' });
```

## Grammar

The tree-sitter grammar is defined in `grammar.js` and supports:
- `.holo` compositions (objects, environments, spatial groups)
- `.hs` templates (agents, streams, events)
- `.hsplus` modules (TypeScript-like types, imports, exports)

## Related

- [`@holoscript/core`](../core/) — Full parser implementations
- [`@holoscript/tree-sitter-holoscript`](../tree-sitter-holoscript/) — Tree-sitter bindings
- [Parser Internals](../../docs/architecture/PARSER_INTERNALS.md) — Architecture doc

## License

MIT
npm package: @holoscript/preview-component
Description: Standalone React component for embedding interactive HoloScript 3D scene previews in GitHub PRs, docs, and playgrounds
Author: Brian X Base Team
Latest version: 0.1.0

# @holoscript/preview-component

Standalone React component for embedding interactive HoloScript 3D scene previews in GitHub PRs, docs, and playgrounds.

## Usage

```bash
pnpm install
```

```tsx
import { HoloPreview } from '@holoscript/preview-component';
import '@holoscript/preview-component/styles.css';
```

Requires `react` and `react-dom` (v18+). `three` is an optional peer dependency.

## Development

```bash
pnpm dev            # Build with watch mode (tsup)
pnpm test           # Run tests (vitest)
pnpm test:coverage  # Run tests with coverage
pnpm typecheck      # Type-check without emitting
```
npm package: @holoscript/r3f-renderer
Description: Shared React Three Fiber renderer components for HoloScript
Author: Brian Joseph
Latest version: 6.0.3

# @holoscript/r3f-renderer

> Shared React Three Fiber renderer components for HoloScript.

## Overview

Provides reusable R3F (React Three Fiber) components that render HoloScript compositions in the browser. Used by HoloScript Studio and the `preview` command.

## Key Components

| Component         | Purpose                                                  |
| ----------------- | -------------------------------------------------------- |
| `SceneRenderer`   | Renders full compositions as R3F scenes                  |
| `ObjectRenderer`  | Individual object rendering with trait mapping           |
| `TraitVisualizer` | Visual representation of traits (bounding boxes, gizmos) |
| `MaterialMapper`  | Maps HoloScript materials to Three.js materials          |

## Usage

```tsx
import { SceneRenderer } from '@holoscript/r3f-renderer';

function Preview({ composition }) {
  return (
    <Canvas>
      <SceneRenderer composition={composition} />
    </Canvas>
  );
}
```

## Features

- PBR material rendering
- Particle system support
- Post-processing effects (bloom, SSAO, DOF)
- GPU instancing for large scenes
- LOD management

## Related

- [`@holoscript/studio`](../studio/) — Uses this for the visual editor
- [`@holoscript/spatial-engine`](../spatial-engine/) — Native spatial computation
- [CompilerBridge](../core/src/compiler/CompilerBridge.ts) — R3F compilation target

## License

MIT
npm package: @holoscript/robotics-plugin
Description: HoloScript plugin for robotics: compile-time USD/URDF codegen + runtime ROS2/Gazebo integration. VR robot programming and digital twins.
Author: HoloScript Contributors
Latest version: 1.0.0

# @holoscript/robotics-plugin
**ROS2 + Gazebo for HoloScript** - VR robot programming & digital twins
🤖 Teleoperation | 🎮 VR control | 📐 URDF export | 🔧 Digital twins
npm package: @holoscript/sdk
Description: @deprecated — Use @holoscript/core directly. This package is a thin re-export shim kept for backward compatibility. Will be removed in a future major release. (A.011.06d)
Author: Brian X Base Team
Latest version: 6.0.3

# @holoscript/sdk

HoloScript Smart Asset SDK and HoloHub client integration.

## Installation

```bash
npm install @holoscript/sdk
```

## Overview

This package provides the SDK for creating and managing HoloScript Smart Assets and interacting with the HoloHub platform. It is **not** a CLI toolkit — for CLI tools, see [`@holoscript/cli`](../cli/README.md).

## Usage

```typescript
import { HoloSmartAsset, HoloHubClient } from '@holoscript/sdk';
```

### Smart Assets

Create and manage smart assets with schema validation powered by Zod:

```typescript
import { HoloSmartAsset } from '@holoscript/sdk';

const asset = new HoloSmartAsset({
  name: 'Interactive Cube',
  traits: ['@grabbable', '@physics'],
  geometry: 'cube',
});
```

### HoloHub Client

Connect to the HoloHub platform for asset publishing and discovery:

```typescript
import { HoloHubClient } from '@holoscript/sdk';

const client = new HoloHubClient({
  apiKey: process.env.HOLOHUB_API_KEY,
});
```

## Related Packages

- [`@holoscript/core`](../core/README.md) - Parser, compiler, and runtime
- [`@holoscript/cli`](../cli/README.md) - Command-line tools (`holoscript build`, `holoscript run`, etc.)
- [`@holoscript/mcp-server`](../mcp-server/README.md) - MCP tools for AI agents

## License

MIT
npm package: @holoscript/snn-poc
Description: Standalone WebGPU compute shader proof-of-concept for LIF spiking neural network simulation with CPU reference validation
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/snn-poc

> Standalone WebGPU compute shader proof-of-concept for LIF spiking neural network simulation with CPU reference validation.

## Overview

A proof-of-concept implementation of a Leaky Integrate-and-Fire (LIF) spiking neural network running entirely on WebGPU compute shaders. Includes a CPU reference implementation for validation and correctness testing.

## Architecture

```text
┌──────────────────────────────┐
│  WebGPU Compute Pipeline     │
│  ├── LIF Neuron Kernel       │
│  ├── Synapse Weight Update   │
│  └── Spike Propagation       │
└──────────────┬───────────────┘
               │ verify
               ▼
┌──────────────────────────────┐
│  CPU Reference               │
│  ├── Same LIF math           │
│  └── Bit-for-bit comparison  │
└──────────────────────────────┘
```

## Usage

```typescript
import { SNNSimulator } from '@holoscript/snn-poc';

const sim = new SNNSimulator({
  neurons: 1000,
  timestep: 0.001,
  backend: 'webgpu', // or 'cpu' for reference
});

await sim.step(100); // Run 100 timesteps
const spikes = sim.getSpikeHistory();
```

## Related

- [`@holoscript/snn-webgpu`](../snn-webgpu/) — Production SNN WebGPU pipeline
- [WebGPU Compiler](../core/src/compiler/WebGPUCompiler.ts)

## License

MIT
npm package: @holoscript/studio-bridge
Description: Bidirectional Visual-to-AST translation bridge between HoloScript Studio visual editor and the HoloScript AST/compiler pipeline
Author: Brian X Base Team
Latest version: 1.0.0

# @holoscript/studio-bridge

> Bidirectional Visual-to-AST translation bridge between HoloScript Studio visual editor and the HoloScript AST/compiler pipeline.

## Overview

The studio-bridge provides bidirectional translation between the visual editor state (drag-and-drop objects, property panels, scene hierarchy) and the HoloScript AST. Changes in the visual editor produce valid AST updates, and changes to the AST are reflected in the visual editor in real-time.

## Architecture

```text
Visual Editor State ←──→ Studio Bridge ←──→ HoloScript AST
    (React/Zustand)     (bidirectional)    (CompositionParser)
```

## Key Components

| Component | Purpose |
|-----------|---------|
| `VisualToAST` | Converts visual editor state to HoloScript AST |
| `ASTToVisual` | Converts HoloScript AST to visual editor state |
| `BridgeSync` | Real-time bidirectional synchronization |
| `ChangeTracker` | Tracks and merges concurrent edits |

## Usage

```typescript
import { StudioBridge } from '@holoscript/studio-bridge';

const bridge = new StudioBridge(composition);

// Visual editor changes → AST
bridge.onVisualChange({ objectId: 'Cube', position: [1, 2, 3] });
const updatedAST = bridge.getAST();

// AST changes → Visual editor
bridge.onASTChange(newAST);
const visualState = bridge.getVisualState();
```

## Related

- [`@holoscript/studio`](../studio/) — Visual editor UI
- [`@holoscript/core`](../core/) — Parser and AST types
- [Parser Internals](../../docs/architecture/PARSER_INTERNALS.md)

## License

MIT
npm package: @holoscript/uaal
Description: uAAL — Universal Autonomous Agent Language VM. Stack-based bytecode execution engine for the uAA2++ 7-Phase Protocol.
Author: Brian X Base Team
Latest version: 6.0.3

# @holoscript/uaal

**uAAL** — Universal Autonomous Agent Language Virtual Machine.  
Stack-based bytecode execution engine for the **uAA2++ 7-Phase Protocol**.

## Quick Start

```ts
import { UAALVirtualMachine, UAALCompiler, UAALOpCode } from '@holoscript/uaal';

const vm = new UAALVirtualMachine();
const compiler = new UAALCompiler();

// Build a full 7-phase cognitive cycle
const bytecode = compiler.buildFullCycle('Analyze the market data');
const result = await vm.execute(bytecode);
// result.taskStatus === 'HALTED'
```

## Custom Handlers

The `registerHandler()` API is the extension point. Your private services inject logic without modifying the VM core:

```ts
vm.registerHandler(UAALOpCode.OP_INVOKE_LLM, async (proxy, operands) => {
  const result = await myLLMService.call(operands[0] as string);
  proxy.push(result);
});
```

## 7-Phase Protocol

| Phase       | OpCode | Purpose                               |
| ----------- | ------ | ------------------------------------- |
| 0. INTAKE   | `0x10` | Gather data and context               |
| 1. REFLECT  | `0x11` | Analyze and understand                |
| 2. EXECUTE  | `0x14` | Take action                           |
| 3. COMPRESS | `0x12` | Store knowledge efficiently           |
| 4. REINTAKE | `0x15` | Re-evaluate with compressed knowledge |
| 5. GROW     | `0x16` | Learn patterns, wisdom, gotchas       |
| 6. EVOLVE   | `0x17` | Adapt and optimize                    |

## Scripts

```bash
npm run test    # Run tests
npm run build   # Build to dist/
npm run dev     # Watch mode
```
npm package: @holoyan/morph-map-js
Description: Morph map class
Latest version: 0.1.2

# Framework-agnostic Morph map class

Checkout other my packages

- [AdonisJs Permissions](https://github.com/holoyan/adonisjs-permissions)
- [AdonisJs activity log](https://github.com/holoyan/adonisjs-activitylog)


## Description

The Solo purpose of this package is to provide a morph map class that can be used to register and resolve morph maps for classes.


## Installation

```bash
  npm i @holoyan/morph-map-js
  
```

# Usage

### Binding a morph map

```ts
import { MorphMap } from '@holoyan/morph-map'

MorphMap('users')
class User {
    
}

```

### Resolving a morph map

```ts
import { morphMap } from '@holoyan/morph-map' // NOTE: lowercase import


const User = morphMap.get('users')
morphMap.has('users') // true
morphMap.has('non-existing') // false

class Admin {
  // ...
}

morphMap.set('Admins', Admin)

morphMap.get('Admins') // Admin class
morphMap.has('Admins') // true

morphMap.hasTaget(Admin) // true
morphMap.getTarget(Admin) // 'Admins' 


```
npm package: @holper/react-native-holper-storybook
Description: A component library for Holper projects
Latest version: 0.8.0

#### Building for npm

Change in package.json the main prop:

From: `"main": "node_modules/expo/AppEntry.js",`

To: `"main": "lib/index.js",`

And revert the change after publish.



#### Publish the library for npm

Run the command: `npm publish` this will build the lib before publishing.

#### How to set up
`import { asyncLoadFont } from  from 'react-native-holper-storybook';` and call the `asyncLoadFont` function in your app entry point.

```
import React, { useEffect, useState } from 'react';
import { asyncLoadFont } from 'react-native-holper-storybook';

export default function App() {
  const [fontsLoaded, setFontsLoaded] = useState(false);

  useEffect(() => {
    (async function() {
      await asyncLoadFont;
      setFontsLoaded(true);
    })();
  }, []);

  if (!fontsLoaded) {
    return <View/>;
  }

  return (
    ...
  );
}
```

#### Using FlashMessage
This library uses https://www.npmjs.com/package/react-native-flash-message, in order to use it, include `<FlashMessage/>` in you root component.

```
import React from 'react';
import { View } from 'react-native';
import { FlashMessage } from 'react-native-holper-storybook';

export default function App() {
  return (
    <View>
        ...
        <FlashMessage />
    </View>
  );
}
```

###### Sending a messages

```
import React from 'react';
import { View } from 'react-native';
import { Text, Button, sendMessage } from 'react-native-holper-storybook';

export default MyComponent = () => {
  return (
    <View style={styles.container}>
      <Button onPress={() => sendMessage({variant: 'success', message: 'The title', description: 'The description'})}>
        <Text color='white'>Shows success message</Text>
      </Button>

      <Button variant='error' onPress={() => sendMessage({variant: 'error', message: 'The title', description: 'The description'})}>
        <Text color='white'>Shows error message</Text>
      </Button>
    </View>
  );
}
```
npm package: @holusion/logger
Description: simple logs formatter
Author: Sebastien DUMETZ
Latest version: 1.2.0

# node-logger
Formated output for logger with prio-prefix


To be used with [logger](https://linux.die.net/man/1/logger) or [systemd-cat](https://www.freedesktop.org/software/systemd/man/latest/systemd-cat.html).

When used over a tty, the output is formated as with a normal `console.log`. However when piped, a prio-prefix is added to the output.



Example syntax : 



## Types

Generate / update types using : 

    npx -p typescript tsc ./lib/*.js --declaration --allowJs --emitDeclarationOnly --outDir types
npm package: @holusion/product-scanner
Description: MDNS network scanner for holusion products
Author: Sebastien DUMETZ
Latest version: 3.1.0

# product-scanner
MDNS network scanner for holusion products

 > Example usage : see [example.js](https://github.com/Holusion/product-scanner/blob/master/example.js).

## Import

```
import ProductScanner from "@holusion/product-scanner";
const s = new ProductScanner(); //Defaults are usually good
```

## API

### Events

#### error

forwards errors from [multicast-dns](https://www.npmjs.com/package/multicast-dns).

#### ready

emits a **ready** event once multicast-dns started successfully
It is necessary to wait for it before calling `ProductScanner.refresh()`.

#### change

emitted each time a new node is detected or some node is updated.

Does not perform deduplication so it might get called a lot on noisy networks.

#### remove

Emitted with the node's **host** property if a node is removed, either due to timeout or graceful shutdown


### Methods

#### refresh(ids :string, timeout:number=500)

force-refresh a list of hosts within a set time.

Everything that did not respond on time will be removed through the emission of a "remove" event.

Resolves once the timeout expires or all nodes answered.

#### close()

closes the scanner and the underlying multicast-dns socket if using the default one.


## Improvements

 - currently no difference is made between services ttl (long) and addresses ttl (short). a record-dependant refresh cycle could be established
 - refresh could be improved. It currently does a broadcast instead of sending requests only to target nodes
 - some "network health" statistics could be gathered to use a network-dependant value for refresh's timeout.
npm package: @holusion/react-components-holusion
Description: ## Components
Author: Yann DUBOIS
Latest version: 1.0.0

# react-components-holusion : a collection of components made with react

## Components

### Button

A button is a clickable component that fits with its parent container https://material.io/design/components/buttons.html#specs

| Props    | Types               | Description              |
| -------- | ------------------- | ------------------------ |
| children | string or component | It is the button content |

### Card

A card is a component that describe an item which can have an image and some interaction (like selection)

| Props   | Types                  | Description                       |
| ------- | ---------------------- | --------------------------------- |
| top     | One or more components | Represents the top of the card    |
| primary | One or more components | Represents the all the card       |
| bottom  | One or more components | Represents the bottom of the card |
| image   | string                 | The background image              |

### PlaylistItem

A PlaylistItem is a card that represents an item of a Playlist

| Props | Types  | Description                            |
| ----- | ------ | -------------------------------------- |
| item  | object | The item that will be change in a card |
| image | string | The background image                   |

the props item should have this properties :

```javascript
{
    "name": string,
    "rank": int,
    "active": bool,
    "_id": string
}
```

You can had options like this : 

```javascript
{
    "name": string,
    "rank": int,
    "active": bool,
    "_id": string,
    "options": {
        "onCheckboxChange": func(item, event),
        "onSwitchChange": func(item, event),
        "onClick": func(item, event),
        "onPlay": func(item, event),
        "onRemove": func(item, event),
        "current": bool,
        "selected": bool,
        "visible": bool,
        "image": string
    }
}
```

### Playlist

A Playlist is a collection of PlaylistItem create by a collection of items

| Props | Types           | Description                                               |
| ----- | --------------- | --------------------------------------------------------- |
| items | array of object | A collection of items that will be passed on PlaylistItem |
npm package: @holusion/theme
Description: Site web pour SAS Holusion : https://holusion.com
Latest version: 2.2.1

# Introduction

Site web pour SAS Holusion : https://holusion.com

Aussi utilisé pour publier un thème bootstrap personnalisé : [@holusion/theme](https://www.npmjs.com/package/@holusion/theme).

## DEVELOPPEMENT

voir le wiki [Wiki](https://github.com/Holusion/holusion.com/wiki).

Developpé avec [Jekyll](https://jekyllrb.com/). Les [issues](https://github.com/Holusion/holusion.com/issues) pour rapporter toute erreur.

## Deploiement

Le site web est déployé à chaque `push` sur la branche master

Le theme bootstrap est déployé à chaque tag de type `v*.*.*` créé. Typiquement, comme la branche master est protégée, le workflow sera :

 - créer une feature branch
 - lancer `npm version x.x.x --no-git-tag-version`
 - push et merge la branche
 - Dans l'interface GitHub sur la branche master, créer un tag correspondant à la nouvelle version

## UTILISATION DU THEME

```
  import "@holusion/theme"; //importe le thème CSS complet
```