From c4034857c7b6f0cd30e64ce93c8ad636c03c20c7 Mon Sep 17 00:00:00 2001
From: Sean O'Connor <sean@soconnor.dev>
Date: Thu, 11 Sep 2025 11:27:28 -0400
Subject: [PATCH] Add README, .gitignore, and clean up build artifacts

- Added comprehensive README with usage instructions
- Added .gitignore to prevent build artifacts from being committed
- Removed target/ directories and duplicate WASM files
- Cleaned up parser binaries and test files
---
 .gitignore   |  25 +++++++++++++++++++++++++
 README.md    |  48 ++++++++++++++++++++++++++++++++++++++++++++++++
 parser.dylib | Bin 33824 -> 0 bytes
 3 files changed, 73 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md
 delete mode 100755 parser.dylib

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..255d670
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,25 @@
+# Build artifacts
+target/
+*.wasm
+*.dylib
+*.so
+*.dll
+*.dylib
+*.a
+*.o
+
+# Node modules
+node_modules/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ac41c43
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# tree-sitter-hack-binary
+
+A [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) grammar for Hack Binary machine code as used in the [nand2tetris](https://www.nand2tetris.org/) course.
+
+## Supported File Types
+
+- `.hack` - Hack Binary machine code files
+
+## Features
+
+- **Syntax highlighting** for 16-bit binary instructions
+- **Code navigation** with outline support
+- **Integration** with Zed editor and other Tree-sitter compatible editors
+
+## Usage
+
+This grammar is designed to work with the [nand2tetris-zed](https://github.com/soconnor0919/nand2tetris-zed) extension for Zed editor, providing complete language support for the nand2tetris course.
+
+## Grammar Details
+
+- **Language**: Hack Binary
+- **Scope**: `source.hack_binary`
+- **File Types**: `.hack`
+
+## Development
+
+### Building
+
+```bash
+# Generate parser
+tree-sitter generate
+
+# Build parser
+tree-sitter build
+
+# Test grammar
+tree-sitter test
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Related
+
+- [nand2tetris-zed](https://github.com/soconnor0919/nand2tetris-zed) - Complete Zed extension
+- [nand2tetris.org](https://www.nand2tetris.org/) - Course website
+- [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) - Parser generator
diff --git a/parser.dylib b/parser.dylib
deleted file mode 100755
index 7881b8398d0c6b96ba1bf1885086b2f577d23a69..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 33824
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