docs: update readme

Author: JairusSW

.github/dependabot.yml

@@ -1,11 +1,36 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+# Dependabot configuration
+# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates
 
 version: 2
 updates:
-  - package-ecosystem: "npm" # Set to npm since you're using npm
-    directory: "/" # Location of package manifests, assuming package.json is at the root
+  # NPM dependencies
+  - package-ecosystem: "npm"
+    directory: "/"
     schedule:
-      interval: "weekly" # Frequency of updates: "daily", "weekly", or "monthly"
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 10
+    commit-message:
+      prefix: "chore(deps)"
+    labels:
+      - "dependencies"
+    groups:
+      # Group minor and patch updates together
+      minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    commit-message:
+      prefix: "chore(ci)"
+    labels:
+      - "ci"
+      - "dependencies"

.github/workflows/tests.yml

@@ -1,10 +1,31 @@
-name: Bun/Wasmtime CI
+name: CI
 
 on: [push, pull_request]
 
 jobs:
-  build:
+  # Type checking and linting
+  check:
     runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install Dependencies
+        run: bun install
+
+      - name: TypeScript Type Check
+        run: bun run typecheck
+
+      - name: Lint
+        run: bun run lint
+
+  # Build and test
+  test:
+    runs-on: ubuntu-latest
+    needs: check
 
     steps:
       - name: Checkout the repository
@@ -21,5 +42,8 @@ jobs:
       - name: Install Dependencies
         run: bun install
 
+      - name: Build Transform
+        run: bun run build:transform
+
       - name: Run Tests
         run: bash ./run-tests.sh

README.md

@@ -18,6 +18,8 @@
   - [Performance Tuning](#performance-tuning)
   - [Running Benchmarks Locally](#running-benchmarks-locally)
 - [Debugging](#debugging)
+- [Architecture](#architecture)
+- [Contributing](#contributing)
 - [Who uses it?](#who-uses-it)
 - [License](#license)
 - [Contact](#contact)
@@ -476,6 +478,19 @@ or
 `JSON_DEBUG=2` - The above and prints keys/values as they are deserialized
 `JSON_WRITE=path-to-file.ts` - Writes out generated code to `path-to-file.json.ts` for easy inspection
 
+## Architecture
+
+For a deep dive into how json-as works internally, including the transform system, optimization modes (NAIVE, SWAR, SIMD), and buffer management, see [ARCHITECTURE.md](./ARCHITECTURE.md).
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on:
+
+- Setting up your development environment
+- Running tests and benchmarks
+- Code style and commit conventions
+- The pull request process
+
 ## Who uses it?
 
 A few companies and open-source projects use json-as!
@@ -492,7 +507,9 @@ A few companies and open-source projects use json-as!
 
 ## License
 
-This project is distributed under an open source license. You can view the full license using the following link: [License](./LICENSE)
+This project is distributed under an open source license. Work on this project is done by passion, but if you want to support it financially, you can do so by making a donation to the project's [GitHub Sponsors](https://github.com/sponsors/JairusSW) page.
+
+You can view the full license using the following link: [License](./LICENSE)
 
 ## Contact
 

assembly/__tests__/test.spec.ts

@@ -74,3 +74,12 @@
 @inline export const FORM_FEED = 12; // \f
 // @ts-ignore: Decorator is valid here
 @inline export const CARRIAGE_RETURN = 13; // \r
+
+// Pre-encoded u64 constants for common JSON literals
+// These represent the UTF-16 encoded bytes stored as u64 for fast comparison/storage
+// @ts-ignore: Decorator is valid here
+@inline export const NULL_WORD_U64: u64 = 30399761348886638; // "null" as u64 (n=110, u=117, l=108, l=108)
+// @ts-ignore: Decorator is valid here
+@inline export const TRUE_WORD_U64: u64 = 28429475166421108; // "true" as u64 (t=116, r=114, u=117, e=101)
+// @ts-ignore: Decorator is valid here
+@inline export const FALSE_WORD_U64: u64 = 32370086184550502; // "fals" as u64 (f=102, a=97, l=108, s=115) - first 4 chars of "false"