@holoscript/parser 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,44 @@
+# @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

package/dist/index.d.ts

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

package/dist/index.js

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@holoscript/parser",
+  "version": "1.0.0",
+  "description": "HoloScript parser — tree-sitter grammars, tokenizer, AST types. Rust/WASM candidate.",
+  "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/parser"
+  },
+  "dependencies": {
+    "@holoscript/core": "5.1.1"
+  },
+  "optionalDependencies": {
+    "tree-sitter": "0.21.1",
+    "tree-sitter-go": "^0.25.0",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-python": "^0.25.0",
+    "tree-sitter-rust": "^0.24.0",
+    "tree-sitter-typescript": "^0.23.2",
+    "web-tree-sitter": "^0.24.0"
+  },
+  "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,13 @@
+/**
+ * @holoscript/parser — Parser & AST
+ *
+ * Re-exports parser subsystem from @holoscript/core.
+ * 58 files, 25K LOC. Candidate for Rust/WASM port.
+ *
+ * Usage:
+ *   import { parse, tokenize, HoloScriptAST } from '@holoscript/parser';
+ */
+
+// Re-export parser from core subpath
+// Phase 2: parser source files will be moved here
+export * from '@holoscript/core/parser';

package/tsconfig.json

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