@holoscript/traits 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,89 @@
+# @holoscript/traits
+
+> Standard trait library for HoloScript — 2,000+ semantic traits across 40+ categories.
+
+## Overview
+
+The traits package provides the complete vocabulary of HoloScript traits organized into domain-specific categories. Traits are semantic annotations (`@physics`, `@grabbable`, `@ai_agent`) that describe WHAT an entity is — the compiler handles HOW it runs on each platform.
+
+## Trait Architecture
+
+```
+CrossRealityTraitRegistry          TraitDependencyGraph
+  ├── register(trait)               ├── objectTraits (mapping)
+  ├── getByCategory(cat)            └── resolve dependencies
+  ├── getAllTraitIds()
+  └── registerBuiltinTraits()
+
+TraitSupportMatrix                 MoMETraitDatabase
+  └── detectCategory(path)          ├── listCategory(cat)
+                                    └── TraitExpert.category
+```
+
+## Categories
+
+| Category | Examples | Count |
+|----------|----------|-------|
+| **Core VR** | `@grabbable`, `@throwable`, `@pointable`, `@teleport` | 50+ |
+| **Physics** | `@rigidbody`, `@collider`, `@force_field`, `@joint` | 80+ |
+| **Audio** | `@spatial_audio`, `@reverb`, `@audio_zone` | 30+ |
+| **Visual** | `@pbr_material`, `@glass_material`, `@toon_material` | 600+ |
+| **AI/Agents** | `@agent`, `@llm_agent`, `@patrol`, `@behavior_tree` | 65+ |
+| **IoT** | `@iot_sensor`, `@digital_twin`, `@mqtt_bridge` | 40+ |
+| **Robotics** | `@joint_revolute`, `@force_torque_sensor`, `@urdf` | 213+ |
+| **Economy** | `@credit`, `@marketplace`, `@escrow` | 20+ |
+| **Networking** | `@networked`, `@crdt_state`, `@voice_chat` | 50+ |
+| **Shader** | `@gaussian_splat`, `@subsurface`, `@toon_shader` | 100+ |
+
+See `src/traits/constants/` for the full list of 101 category files.
+
+## Usage
+
+```typescript
+import { VR_TRAITS } from '@holoscript/traits';           // All traits
+import { PHYSICS_TRAITS } from '@holoscript/traits';       // Physics only
+import { MAGIC_FANTASY_TRAITS } from '@holoscript/traits'; // Magic/Fantasy only
+```
+
+### Registering Custom Traits
+
+```typescript
+import { CrossRealityTraitRegistry } from '@holoscript/core';
+
+const registry = new CrossRealityTraitRegistry();
+registry.registerBuiltinTraits();
+registry.register({
+  id: 'my_custom_trait',
+  category: 'gameplay',
+  properties: { damage: 'number', range: 'number' },
+});
+```
+
+### Detecting Trait Category
+
+```typescript
+import { detectCategory } from '@holoscript/core';
+
+const category = detectCategory('src/traits/constants/physics.ts', content);
+// → 'physics'
+```
+
+## Key Classes
+
+| Class | File | Purpose |
+|-------|------|---------|
+| `CrossRealityTraitRegistry` | `core/src/compiler/platform/` | Register, query, and manage traits across platforms |
+| `TraitDependencyGraph` | `core/src/compiler/` | Track trait-to-object mappings and dependencies |
+| `TraitSupportMatrix` | `core/src/traits/` | Category detection and platform support matrix |
+| `MoMETraitDatabase` | `core/src/traits/` | Mixture-of-Memory-Experts trait database |
+| `ShaderTrait` | `core/src/traits/` | Shader compilation for all targets |
+| `GLTFTrait` | `core/src/traits/` | glTF extension requirements |
+
+## Related
+
+- [Traits Reference](../../docs/traits/index.md) — Usage docs for all categories
+- [CrossRealityTraitRegistry](../../docs/architecture/TRAIT_SYSTEM.md) — Architecture deep-dive
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.js

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@holoscript/traits",
+  "version": "1.0.0",
+  "description": "HoloScript standard traits library — 1,800+ trait definitions for spatial computing",
+  "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/traits"
+  },
+  "dependencies": {
+    "@holoscript/core": "5.1.1"
+  },
+  "devDependencies": {
+    "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,15 @@
+/**
+ * @holoscript/traits — Standard Traits Library
+ *
+ * Public API for HoloScript's 1,800+ trait definitions.
+ * Re-exports from @holoscript/core/traits barrel.
+ *
+ * Usage:
+ *   import { Transform, Renderable, PhysicsBody } from '@holoscript/traits';
+ *
+ * This is the canonical entry point for traits.
+ * Source files live in @holoscript/core/src/traits/ (Phase 2 keeps them in core
+ * due to back-imports into ../types, ../runtime, ../agents).
+ */
+
+export * from '@holoscript/core/traits';

package/tsconfig.json

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