json-as 1.2.0 → 1.2.2-beta.1

package/README.md

@@ -392,9 +392,9 @@ The following charts compare JSON-AS (both SWAR and SIMD variants) against JavaS
 
 > Note: Benchmarks reflect the **latest version**. Older versions may show different performance.
 
-<img src="https://raw.githubusercontent.com/JairusSW/json-as/refs/heads/docs/data/chart01.svg" alt="Performance Chart 1">
+<img src="https://raw.githubusercontent.com/JairusSW/json-as/refs/heads/docs/charts/chart01.svg" alt="Performance Chart 1">
 
-<img src="https://raw.githubusercontent.com/JairusSW/json-as/refs/heads/docs/data/chart02.svg" alt="Performance Chart 2">
+<img src="https://raw.githubusercontent.com/JairusSW/json-as/refs/heads/docs/charts/chart02.svg" alt="Performance Chart 2">
 
 > Note: I have focused on extensively optimizing serialization. I used to have deserialization be highly unsafe and extremely fast, but I've since doubled down on safety for deserialization which has negatively affected performance. I will be optimizing soon.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-as",
-  "version": "1.2.0",
+  "version": "1.2.2-beta.1",
   "author": "Jairus Tanaka",
   "repository": {
     "type": "git",

package/.github/FUNDING.yml

@@ -1 +0,0 @@
-github: [JairusSW]

package/.github/dependabot.yml

@@ -1,11 +0,0 @@
-# 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
-
-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
-    schedule:
-      interval: "weekly" # Frequency of updates: "daily", "weekly", or "monthly"

package/.github/workflows/benchmark.yml

@@ -1,72 +0,0 @@
-name: Benchmark
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-  workflow_dispatch:
-  repository_dispatch:
-
-jobs:
-  benchmark:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v3
-        continue-on-error: false
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        continue-on-error: true
-
-      - name: Install Dependencies
-        run: bun install || true
-        continue-on-error: true
-
-      - name: Install JSVU and V8
-        run: |
-          bunx jsvu --os=linux64 --engines=v8 || true
-          echo "${HOME}/.jsvu/bin" >> $GITHUB_PATH
-        continue-on-error: true
-
-      - name: Install Binaryen
-        run: sudo apt-get update && sudo apt-get install -y binaryen || true
-        continue-on-error: true
-
-      - name: Run AssemblyScript Benchmarks
-        run: ./run-bench.as.sh || true
-        continue-on-error: true
-
-      - name: Run JavaScript Benchmarks
-        run: ./run-bench.js.sh || true
-        continue-on-error: true
-
-      - name: Build Charts
-        run: |
-          mkdir -p data
-          bun ./scripts/build-chart01.ts || true
-          bun ./scripts/build-chart02.ts || true
-        continue-on-error: true
-
-      - name: Commit Charts to docs branch
-        continue-on-error: true
-        run: |
-          set -e
-          git config user.name "github-actions"
-          git config user.email "actions@github.com"
-
-          # Ensure the docs branch exists locally
-          git fetch origin docs || true
-          if git rev-parse --verify docs >/dev/null 2>&1; then
-            git branch -D docs || true
-          fi
-          git checkout -b docs origin/docs || git checkout --orphan docs || true
-
-          # Copy generated charts
-          mkdir -p charts
-          cp data/*.svg charts/ || true
-
-          git add charts/ || true
-          git commit -m "Update benchmark charts [skip ci]" || echo "No changes to commit"
-          git push origin docs --force || true

package/.github/workflows/release-package.yml

@@ -1,47 +0,0 @@
-name: Node.js Package
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 16
-
-      - name: Install Wasmtime
-        uses: jcbhmr/setup-wasmtime@v2
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v2
-
-      - name: Install dependencies
-        if: steps.node-cache.outputs.cache-hit != 'true'
-        run: yarn
-
-      - name: Build tests
-        run: yarn run tests:build
-
-      - name: Perform tests
-        run: yarn run test
-
-  publish-gpr:
-    needs: build
-    runs-on: ubuntu-latest
-    permissions:
-      packages: write
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 22
-          registry-url: https://npm.pkg.github.com/
-      - run: npm ci
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

package/.github/workflows/tests.yml

@@ -1,25 +0,0 @@
-name: Bun/Wasmtime CI
-
-on: [push, pull_request]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout the repository
-        uses: actions/checkout@v4
-
-      - name: Install Wasmtime
-        run: |
-          curl https://wasmtime.dev/install.sh -sSf | bash
-          echo "$HOME/.wasmtime/bin" >> $GITHUB_PATH
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-
-      - name: Install Dependencies
-        run: bun install
-
-      - name: Run Tests
-        run: bash ./run-tests.sh

package/.prettierignore

@@ -1,9 +0,0 @@
-# Build artifacts
-build/
-transform/lib
-
-# Tables
-assembly/globals/tables.ts
-
-# Markdown
-*.md

package/.prettierrc.json

@@ -1,7 +0,0 @@
-{
-  "pluginSearchDirs": ["node_modules"],
-  "plugins": ["assemblyscript-prettier"],
-  "singleQuote": false,
-  "printWidth": 65536,
-  "tabWidth": 2
-}

package/.trunk/configs/.markdownlint.yaml

@@ -1,2 +0,0 @@
-# Prettier friendly markdownlint config (all formatting rules disabled)
-extends: markdownlint/style/prettier

package/.trunk/configs/.shellcheckrc

@@ -1,7 +0,0 @@
-enable=all
-source-path=SCRIPTDIR
-disable=SC2154
-
-# If you're having issues with shellcheck following source, disable the errors via:
-# disable=SC1090
-# disable=SC1091

package/.trunk/configs/.yamllint.yaml

@@ -1,7 +0,0 @@
-rules:
-  quoted-strings:
-    required: only-when-needed
-    extra-allowed: ["{|}"]
-  key-duplicates: {}
-  octal-values:
-    forbid-implicit-octal: true

package/.trunk/trunk.yaml

@@ -1,37 +0,0 @@
-# This file controls the behavior of Trunk: https://docs.trunk.io/cli
-# To learn more about the format of this file, see https://docs.trunk.io/reference/trunk-yaml
-version: 0.1
-cli:
-  version: 1.22.10
-# Trunk provides extensibility via plugins. (https://docs.trunk.io/plugins)
-plugins:
-  sources:
-    - id: trunk
-      ref: v1.6.7
-      uri: https://github.com/trunk-io/plugins
-# Many linters and tools depend on runtimes - configure them here. (https://docs.trunk.io/runtimes)
-runtimes:
-  enabled:
-    - go@1.21.0
-    - node@18.20.5
-    - python@3.10.8
-# This is the section where you manage your linters. (https://docs.trunk.io/check/configuration)
-lint:
-  disabled:
-    - markdownlint
-  enabled:
-    - actionlint@1.7.7
-    - checkov@3.2.377
-    - git-diff-check
-    - prettier@3.5.2
-    - shellcheck@0.10.0
-    - shfmt@3.6.0
-    - trufflehog@3.88.13
-    - yamllint@1.35.1
-actions:
-  disabled:
-    - trunk-announce
-    - trunk-check-pre-push
-    - trunk-fmt-pre-commit
-  enabled:
-    - trunk-upgrade-available

package/CHANGELOG.md

@@ -1,330 +0,0 @@
-# Change Log
-
-## 2025-12-23 - 1.2.0
-
-- feat: Implement SWAR based algorithms, SIMD improvements, and better documentation.
-
-## 2025-12-21 - 1.1.26
-
-- chore: remove log
-
-## 2025-12-21 - 1.1.25
-
-- feat: Implement SWAR-based string serialization
-
-## 2025-11-28 - 1.1.24
-
-- feat: Implement a moving average window to determine buffer size (essentially, allow the buffer size to shrink) [#163](https://github.com/JairusSW/json-as/pull/163)
-
-## 2025-11-06 - 1.1.23
-
-- fix: Map keys should follow proper typing and quote rules [#161](https://github.com/JairusSW/json-as/issues/161)
-
-## 2025-09-01 - 1.1.22
-
-- fix: Type aliases should work across files [#154](https://github.com/JairusSW/json-as/issues/154)
-
-## 2025-08-14 - 1.1.21
-
-- fix: JSON.parse on classes with enums [#155](https://github.com/JairusSW/json-as/issues/155)
-- fix: Resolve memory OOB issue within `serializeFloat` function [#153](https://github.com/JairusSW/json-as/issues/153)
-
-## 2025-07-14 - 1.1.20
-
-- feat: enable SIMD string serialization
-
-## 2025-06-30 - 1.1.19
-
-- fix: wrong path used in `readFileSync` when importing from a library
-
-## 2025-06-30 - 1.1.18
-
-- fix: [#150](https://github.com/JairusSW/json-as/issues/150)
-
-## 2025-06-17 - 1.1.17
-
-- fix: add support for classes within namespaces [#147](https://github.com/JairusSW/json-as/pull/147)
-
-## 2025-06-12 - 1.1.16
-
-- tests: properly support nulls (in testing lib)
-- fix: initialize generic properties correctly
-- fix: make generated imports compatible with windows
-- feat: add support for fields marked with `readonly`
-
-## 2025-06-09 - 1.1.15
-
-- feat: add `.as<T>()` method to `JSON.Value`
-- chore: remove all references to `__SERIALIZE_CUSTOM`
-- feat: add support for `StaticArray` serialization
-- feat: support `JSON.Raw` in array types
-- tests: add tests for `JSON.Raw[]`
-
-## 2025-05-29 - 1.1.14
-
-- fix: hotfix schema resolver
-
-## 2025-05-29 - 1.1.13
-
-- fix: small issues with schema linking
-- tests: add tests for schema linking and discovery
-
-## 2025-05-29 - 1.1.12
-
-- fix: add helpful warning on unknown or unaccessible types in fields
-- feat: support deserialization of class generics
-- fix: add support for numerical generics
-- tests: add proper testing for generics
-- feat: support type aliases with a custom type resolver/linker
-- chore: add other linkers to tsconfig and clean up
-- feat: add type alias resolving
-
-## 2025-05-28 - 1.1.11
-
-- fix: class resolving should only search top level statements for class declarations
-- fix: add helpful error if class is missing an @json decorator
-- fix: properly calculate relative path when json-as is a library
-- fix: add proper null check when resolving imported classes
-
-## 2025-05-28 - 1.1.10
-
-- feat: add more debug levels (1 = print transform code, 2 = print keys/values at runtime)
-- feat: add write out feature (`JSON_WRITE=path-to-file.ts`) which writes out generated code
-- fix: complete full parity between port and original version for correct deserialization of all types
-- feat: add proper schema resolution and dependency resolution
-- feat: add proper type resolution to schema fields
-- fix: properly calculate the relative path between imports to modules
-
-## 2025-05-27 - 1.1.9
-
-- change: strict mode is disabled by default. Enable it with JSON_STRICT=true
-- fix: should ignore properties of same length and type if no matching key exists
-- fix: should ignore properties of different type if no matching key exists
-- fix: should ignore complex properties if no matching key exists
-
-## 2025-05-27 - 1.1.8
-
-- feat: add support for calling `JSON.stringify/JSON.parse` methods inside of custom serializers, but not yet deserializers
-
-## 2025-05-27 - 1.1.7
-
-- fix: bad boolean logic to decide whether to add 2nd break statement
-
-## 2025-05-23 - 1.1.6
-
-- fix: null and boolean fields would miscalculate offsets when deserializing
-
-## 2025-05-23 - 1.1.5
-
-- fix: index.js didn't point to correct file, thus creating a compiler crash
-
-## 2025-05-23 - 1.1.4
-
-- revert: grouping properties in favor of memory.compare
-
-## 2025-05-23 - 1.1.3
-
-- feat: group properties of structs before code generation
-- fix: break out of switch case after completion
-- ci: make compatible with act for local testing
-
-## 2025-05-22 - 1.1.2
-
-- fix: correct small typos in string value deserialization port
-
-## 2025-05-22 - 1.1.1
-
-- fix: remove random logs
-
-## 2025-05-22 - 1.1.0
-
-- fix: change _DESERIALIZE<T> to _JSON_T to avoid populating local scope
-
-## 2025-05-22 - 1.0.9
-
-- fix: [#132](https://github.com/JairusSW/json-as/issues/132)
-- feat: allow base classes to use their child classes if the signatures match
-- perf: rewrite struct deserialization to be significantly faster
-- fix: [#131](https://github.com/JairusSW/json-as/issues/131) Generic classes with custom deserializer crashing
-- fix: [#66](https://github.com/JairusSW/json-as/issues/66) Throw error when additional keys are in JSON
-
-## 2025-05-21 - 1.0.8
-
-- fix: inline warnings on layer-2 serialize and deserialize functions
-- feat: fully support `JSON.Obj` and `JSON.Box` everywhere
-- fix: temp disable SIMD
-- feat: write fair benchmarks with `v8` using `jsvu`
-
-## 2025-05-14 - 1.0.7
-
-- merge: pull request [#128](https://github.com/JairusSW/json-as/pull/128) from [loredanacirstea/nested-custom-serializer-fix](https://github.com/loredanacirstea/nested-custom-serializer-fix)
-
-## 2025-05-12 - 1.0.6
-
-- fix: support zero-param serialization and make sure types are consistent
-- fix: [#124](https://github.com/JairusSW/json-as/issues/124)
-
-## 2025-05-11 - 1.0.5
-
-- feat: add sanity checks for badly formatted strings
-- fix: [#120](https://github.com/JairusSW/json-as/issues/120) handle empty `JSON.Obj` serialization
-- feat: add SIMD optimization if SIMD is enabled by user
-- fix: handle structs with nullable array as property [#123](https://github.com/JairusSW/json-as/pull/123)
-- fix: struct serialization from writing to incorrect parts of memory when parsing nested structs [#125](https://github.com/JairusSW/json-as/pull/125)
-- chore: add two new contributors
-
-## 2025-04-07 - 1.0.4
-
-- fix: paths must be resolved as POSIX in order to be valid TypeScript imports [#116](https://github.com/JairusSW/json-as/issues/116)
-
-## 2025-03-24 - 1.0.3
-
-- fix: make transform windows-compatible [#119](https://github.com/JairusSW/json-as/issues/119?reload=1)
-
-## 2025-03-19 - 1.0.2
-
-- fix: include check for nullable types for properties when deserialization is called internally [#118](https://github.com/JairusSW/json-as/pull/118)
-
-## 2025-03-10 - 1.0.1
-
-- docs: add comprehensive performance metrics
-
-## 2025-03-09 - 1.0.0
-
-- fix: relative paths pointing through node_modules would create a second Source
-- feat: move behavior of `--lib` into transform itself
-- fix: object with an object as a value containing a rhs bracket or brace would exit early [3b33e94](https://github.com/JairusSW/json-as/commit/3b33e9414dc04779d22d65272863372fcd7af4a6)
-
-## 2025-03-04 - 1.0.0-beta.17
-
-- fix: forgot to build transform
-
-## 2025-03-04 - 1.0.0-beta.16
-
-- fix: isPrimitive should only trigger on actual primitives
-
-## 2025-03-04 - 1.0.0-beta.15
-
-- fix: deserialize custom should take in string
-
-## 2025-03-04 - 1.0.0-beta.14
-
-- fix: reference to nonexistent variable during custom deserialization layer 2
-
-## 2025-03-04 - 1.0.0-beta.13
-
-- fix: forgot to actually build the transform
-
-## 2025-03-04 - 1.0.0-beta.12
-
-- fix: build transform
-
-## 2025-03-04 - 1.0.0-beta.11
-
-- fix: wrongly assumed pointer types within arbitrary deserialization
-- fix: wrong pointer type being passed during map deserialization
-
-## 2025-03-04 - 1.0.0-beta.10
-
-- fix: transform not generating the right load operations for keys
-- fix: whitespace not working in objects or struct deserialization
-- fix: JSON.Raw not working when deserializing as Map<string, JSON.Raw>
-
-## 2025-03-03 - 1.0.0-beta.9
-
-- rename: change libs folder to lib
-
-## 2025-03-03 - 1.0.0-beta.8
-
-- docs: add instructions for using `--lib` in README
-
-## 2025-03-03 - 1.0.0-beta.7
-
-- fix: add as-bs to `--lib` section
-- chore: clean up transform
-- refactor: transform should import `~lib/as-bs.ts` instead of relative path
-
-## 2025-03-01 - 1.0.0-beta.6
-
-- fix: import from base directory index.ts
-
-## 2025-03-01 - 1.0.0-beta.5
-
-- fix: revert pull request [#112](https://github.com/JairusSW/json-as/pull/112)
-
-## 2025-02-25 - 1.0.0-beta.4
-
-- fix: warn on presence of invalid types contained in a schema [#112](https://github.com/JairusSW/json-as/pull/112)
-
-## 2025-02-25 - 1.0.0-beta.3
-
-- feat: change `JSON.Raw` to actual class to facilitate proper support without transformations
-- fix: remove old `JSON.Raw` logic from transform code
-
-## 2025-02-25 - 1.0.0-beta.2
-
-- feat: add support for custom serializers and deserializers [#110](https://github.com/JairusSW/json-as/pull/110)
-
-## 2025-02-22 - 1.0.0-beta.1
-
-- perf: add benchmarks for both AssemblyScript and JavaScript
-- docs: publish preliminary benchmark results
-- tests: ensure nested serialization works and add to tests
-- feat: finish arbitrary type implementation
-- feat: introduce `JSON.Obj` to handle objects effectively
-- feat: reimplement arbitrary array deserialization
-- fix: remove brace check on array deserialization
-- feat: introduce native support for `JSON.Obj` transformations
-- feat: implement arbitrary object serialization
-- fix: deserialization of booleans panics on `false`
-- fix: `bs.resize` should be type-safe
-- impl: add `JSON.Obj` type as prototype to handle arbitrary object structures
-- chore: rename static objects (schemas) to structs and name arbitrary objects as `obj`
-- tests: add proper tests for arbitrary types
-- fix: empty method generation using outdated function signature
-- docs: update readme to be more concise
-
-## 2025-02-13 - 1.0.0-alpha.4
-
-- feat: reintroduce support for `Box<T>`-wrapped primitive types
-- tests: add extensive tests to all supported types
-- fix: 6-byte keys being recognized on deserialize
-- perf: take advantage of aligned memory to use a single 64-bit load on 6-byte keys
-- fix: `bs.proposeSize()` should increment `stackSize` by `size` instead of setting it
-- fix: allow runtime to manage `bs.buffer`
-- fix: memory leaks in `bs` module
-- fix: add (possibly temporary) `JSON.Memory.shrink()` to shrink memory in `bs`
-- perf: prefer growing memory by `nextPowerOf2(size + 64)` for less reallocations
-- tests: add boolean tests to `Box<T>`
-- fix: serialization of non-growable data types should grow `bs.stackSize`
-
-## 2025-01-31 - 1.0.0-alpha.3
-
-- fix: write to proper offset when deserializing string with \u0000-type escapes
-- fix: simplify and fix memory offset issues with bs module
-- fix: properly predict minimum size of to-be-serialized schemas
-- fix: replace as-test with temporary framework to mitigate json-as versioning issues
-- fix: fix multiple memory leaks during serialization
-- feat: align memory allocations for better performance
-- feat: achieve a space complexity of O(n) for serialization operations, unless dealing with \u0000-type escapes
-
-## 2025-01-20 - 1.0.0-alpha.2
-
-- fix: disable SIMD in generated transform code by default
-- fix: re-add as-bs dependency so that it will not break in non-local environments
-- fix: remove AS201 'conversion from type usize to i32' warning
-- fix: add as-bs to peer dependencies so only one version is installed
-- fix: point as-bs imports to submodule
-- fix: remove submodule in favor of static module
-- fix: bs.ensureSize would not grow and thus cause memory faults
-- fix: bs.ensureSize triggering unintentionally
-
-## 2025-01-20 - 1.0.0-alpha.1
-
-- feat: finish implementation of arbitrary data serialization and deserialization using JSON.Value
-- feat: reinstate usage of `JSON.Box<T>()` to support nullable primitive types
-- feat: eliminate the need to import the `JSON` namespace when defining a schema
-- feat: reduce memory usage so that it is viable for low-memory environments
-- feat: write to a central buffer and reduce memory overhead
-- feat: rewrite the transform to properly resolve schemas and link them together
-- feat: pre-allocate and compute the minimum size of a schema to avoid memory out of range errors

package/SECURITY.md

@@ -1,32 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported          |
-| ------- | ------------------ |
-| 1.x.x   | Active Development |
-| 0.9.x   | Maintainence       |
-| <=0.8.x | Unsupported        |
-
-## Reporting a Vulnerability
-
-If you believe you have discovered a security vulnerability in this project, please report it as soon as possible. Follow the steps below to report a vulnerability:
-
-1. **Report via GitHub Issues**: Please submit your vulnerability report via the [GitHub Issues](https://github.com/JairusSW/json-as/issues) page. If you prefer, you can also send an email directly to [me@jairus.dev](mailto:me@jairus.dev).
-
-2. **Provide Details**: Include as much detail as possible, including the steps to reproduce, what you believe the impact is, and any suggested remediation if applicable.
-
-3. **Acknowledgment**: Once your report is received, we will acknowledge it within 48 hours. You will then receive an update on the progress of the investigation and a timeline for a potential fix.
-
-4. **Resolution Timeline**:
-
-   - Critical vulnerabilities will be prioritized, and we aim to issue a patch within 7 business days.
-   - Non-critical vulnerabilities will be evaluated and addressed in the next stable release.
-   - If the vulnerability is accepted, a fix will be issued, and a security advisory will be published.
-   - If the vulnerability is declined, you will be notified of the decision with an explanation.
-
-5. **Confidentiality**: Please do not disclose the vulnerability to the public or other parties until the issue has been addressed. This helps ensure that users of the project are not at risk before a patch is available.
-
-6. **Credits**: If your report leads to a fix, we will credit your contribution in the release notes, if you are comfortable with that.
-
-Thank you for helping us keep this project secure!

package/asconfig.json

@@ -1,7 +0,0 @@
-{
-  "targets": {},
-  "options": {
-    "transform": [],
-    "disableWarning": []
-  }
-}

package/assembly/__benches__/abc.bench.ts

@@ -1,28 +0,0 @@
-import { JSON } from "..";
-import { expect } from "../__tests__/lib";
-import { bench, blackbox, dumpToFile } from "./lib/bench";
-
-const v1 = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-const v2 = '"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"';
-
-expect(JSON.stringify(v1)).toBe(v2);
-
-bench(
-  "Serialize Alphabet",
-  () => {
-    blackbox(inline.always(JSON.stringify(v1)));
-  },
-  24_000_00,
-  v1.length << 1,
-);
-dumpToFile("abc", "serialize")
-
-bench(
-  "Deserialize Alphabet",
-  () => {
-    blackbox(inline.always(JSON.parse<string>(v2)));
-  },
-  24_000_00,
-  v2.length << 1,
-);
-dumpToFile("abc", "deserialize")