json-as 1.0.0-alpha.1 → 1.0.0-alpha.3

package/assembly/serialize/simple/array.ts

@@ -1,4 +1,4 @@
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 import { COMMA, BRACKET_RIGHT, BRACKET_LEFT } from "../../custom/chars";
 import { JSON } from "../..";
 
@@ -6,12 +6,12 @@ export function serializeArray<T extends any[]>(src: T): void {
   const end = src.length - 1;
   let i = 0;
   if (end == -1) {
-    bs.ensureSize(4);
+    bs.proposeSize(4);
     store<u32>(bs.offset, 6094939);
     bs.offset += 4;
     return;
   }
-  bs.ensureSize(end << 3);
+  bs.proposeSize(end << 3);
 
   store<u16>(bs.offset, BRACKET_LEFT);
   bs.offset += 2;
@@ -19,14 +19,14 @@ export function serializeArray<T extends any[]>(src: T): void {
   while (i < end) {
     const block = unchecked(src[i++]);
     JSON.__serialize<valueof<T>>(block);
-    bs.ensureSize(2);
+    bs.growSize(2);
     store<u16>(bs.offset, COMMA);
     bs.offset += 2;
   }
 
   const lastBlock = unchecked(src[end]);
   JSON.__serialize<valueof<T>>(lastBlock);
-  bs.ensureSize(2);
+  bs.proposeSize(2);
   store<u16>(bs.offset, BRACKET_RIGHT);
   bs.offset += 2;
 }

package/assembly/serialize/simple/bool.ts

@@ -1,4 +1,4 @@
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 
 /**
  * Serialize a bool to type string
@@ -7,11 +7,11 @@ import { bs } from "../../../modules/bs";
  */
 export function serializeBool(data: bool): void {
   if (data == true) {
-    bs.ensureSize(8);
+    bs.proposeSize(8);
     store<u64>(bs.offset, 28429475166421108);
     bs.offset += 8;
   } else {
-    bs.ensureSize(10);
+    bs.proposeSize(10);
     store<u64>(bs.offset, 32370086184550502);
     store<u64>(bs.offset, 101, 8);
     bs.offset += 10;

package/assembly/serialize/simple/date.ts

@@ -1,11 +1,11 @@
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 import { QUOTE } from "../../custom/chars";
 import { bytes } from "../../util/bytes";
 
 export function serializeDate(src: Date): void {
   const data = src.toISOString();
   const dataSize = bytes(data);
-  bs.ensureSize(dataSize + 4);
+  bs.proposeSize(dataSize + 4);
   store<u16>(bs.offset, QUOTE);
   memory.copy(bs.offset + 2, changetype<usize>(data), dataSize);
   store<u16>(bs.offset + dataSize, QUOTE, 2);

package/assembly/serialize/simple/float.ts

@@ -1,7 +1,7 @@
 import { dtoa_buffered } from "util/number";
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 
 export function serializeFloat<T extends number>(data: T): void {
-  bs.ensureSize(64);
+  bs.proposeSize(64);
   bs.offset += dtoa_buffered(bs.offset, data) << 1;
 }

package/assembly/serialize/simple/integer.ts

@@ -1,7 +1,7 @@
 import { itoa_buffered } from "util/number";
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 
 export function serializeInteger<T extends number>(data: T): void {
-  bs.ensureSize(sizeof<T>() << 3);
+  bs.proposeSize(sizeof<T>() << 3);
   bs.offset += itoa_buffered(bs.offset, data) << 1;
 }

package/assembly/serialize/simple/map.ts

@@ -1,13 +1,13 @@
 import { JSON } from "../..";
 import { BRACE_LEFT, BRACE_RIGHT, COLON, COMMA } from "../../custom/chars";
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 
 export function serializeMap<T extends Map<any, any>>(src: T): void {
   const srcSize = src.size;
   const srcEnd = srcSize - 1;
 
   if (srcSize == 0) {
-    bs.ensureSize(4);
+    bs.proposeSize(4);
     store<u32>(bs.offset, 8192123);
     bs.offset += 4;
     return;
@@ -16,28 +16,28 @@ export function serializeMap<T extends Map<any, any>>(src: T): void {
   let keys = src.keys();
   let values = src.values();
 
-  bs.ensureSize(srcSize << 3); // This needs to be predicted better
+  bs.proposeSize(srcSize << 3); // This needs to be predicted better
 
   store<u16>(bs.offset, BRACE_LEFT);
   bs.offset += 2;
 
   for (let i = 0; i < srcEnd; i++) {
     JSON.__serialize(unchecked(keys[i]));
-    bs.ensureSize(2);
+    bs.growSize(2);
     store<u16>(bs.offset, COLON);
     bs.offset += 2;
     JSON.__serialize(unchecked(values[i]));
-    bs.ensureSize(2);
+    bs.growSize(2);
     store<u16>(bs.offset, COMMA);
     bs.offset += 2;
   }
 
   JSON.__serialize(unchecked(keys[srcEnd]));
-  bs.ensureSize(2);
+  bs.growSize(2);
   store<u16>(bs.offset, COLON);
   bs.offset += 2;
   JSON.__serialize(unchecked(values[srcEnd]));
-  bs.ensureSize(2);
+  bs.growSize(2);
   store<u16>(bs.offset, BRACE_RIGHT);
   bs.offset += 2;
 }

package/assembly/serialize/simple/string.ts

@@ -1,6 +1,6 @@
 import { _intTo16 } from "../../custom/util";
 import { bytes } from "../../util/bytes";
-import { bs } from "../../../modules/bs";
+import { bs } from "../../../modules/as-bs";
 import { BACK_SLASH, QUOTE } from "../../custom/chars";
 import { SERIALIZE_ESCAPE_TABLE } from "../../globals/tables";
 
@@ -11,14 +11,14 @@ import { SERIALIZE_ESCAPE_TABLE } from "../../globals/tables";
  */
 export function serializeString(src: string): void {
   const srcSize = bytes(src);
-  bs.ensureSize(srcSize + 4);
+  bs.proposeSize(srcSize + 4);
   let srcPtr = changetype<usize>(src);
   const srcEnd = srcPtr + srcSize;
 
   store<u16>(bs.offset, QUOTE);
   bs.offset += 2;
 
-  let lastPtr: i32 = srcPtr;
+  let lastPtr: usize = srcPtr;
   while (srcPtr < srcEnd) {
     const code = load<u16>(srcPtr);
     if (code == 34 || code == 92 || code < 32) {
@@ -27,12 +27,12 @@ export function serializeString(src: string): void {
       bs.offset += remBytes;
       const escaped = load<u32>(SERIALIZE_ESCAPE_TABLE + (code << 2));
       if ((escaped & 0xffff) != BACK_SLASH) {
-        bs.ensureSize(10);
+        bs.growSize(10);
         store<u64>(bs.offset, 13511005048209500, 0);
         store<u32>(bs.offset, escaped, 8);
         bs.offset += 12;
       } else {
-        bs.ensureSize(2);
+        bs.growSize(2);
         store<u32>(bs.offset, escaped, 0);
         bs.offset += 4;
       }

package/assembly/test.ts

@@ -1,49 +1,5 @@
-import { JSON } from ".";
-// @json or @serializable work here
-@json
-class Vec3 {
-  x: f64 = 0.0;
-  y: f64 = 0.0;
-  z: f64 = 0.0;
-}
+import { JSON } from "./";
+import { describe, expect } from "../modules/test/assembly";
 
-
-@json
-class Player {
-  // @alias("first name")
-  firstName!: string;
-  lastName!: string;
-  lastActive!: i32[];
-  // Drop in a code block, function, or expression that evaluates to a boolean
-  @omitif((self: Player): boolean => self.age < 18)
-  age!: i32;
-  // @omitnull()
-  pos!: Vec3 | null;
-  isVerified!: boolean;
-  @inline __INITIALIZE(): this {
-    this.firstName = "";
-    this.lastName = "";
-    this.pos = changetype<nonnull<Vec3 | null>>(__new(offsetof<nonnull<Vec3 | null>>(), idof<nonnull<Vec3 | null>>())).__INITIALIZE();
-    return this;
-  }
-}
-
-const player: Player = {
-  firstName: "Jairus",
-  lastName: "Tanaka",
-  lastActive: [1, 20, 2025],
-  age: 18,
-  pos: {
-    x: 3.4,
-    y: 1.2,
-    z: 8.3,
-  },
-  isVerified: true,
-};
-
-const stringified = JSON.stringify<Player>(player);
-console.log("Serialized: " + stringified);
-const parsed = JSON.parse<Player>(stringified);
-console.log("Deserialized: " + JSON.stringify<Player>(parsed));
-
-console.log("Deserialized: " + JSON.stringify(JSON.parse<i32[]>("[1,2,3]")))
+console.log(JSON.stringify(JSON.parse<string>('"\\u0000\\u0001\\u0002\\u0003\\u0004\\u0005\\u0006\\u0007\\b\\t\\n\\u000b\\f\\r\\u000e\\u000f\\u000f\\u0011\\u0012\\u0013\\u0014\\u0015\\u0016\\u0017\\u0018\\u0019\\u001a\\u001b\\u001c\\u001d\\u001e\\u001f"')));
+console.log('"\\u0000\\u0001\\u0002\\u0003\\u0004\\u0005\\u0006\\u0007\\b\\t\\n\\u000b\\f\\r\\u000e\\u000f\\u000f\\u0011\\u0012\\u0013\\u0014\\u0015\\u0016\\u0017\\u0018\\u0019\\u001a\\u001b\\u001c\\u001d\\u001e\\u001f"');

package/assembly/util/bytes.ts

@@ -7,6 +7,6 @@ import { OBJECT, TOTAL_OVERHEAD } from "rt/common";
   } else if (isManaged<T>() || isReference<T>()) {
     return changetype<OBJECT>(changetype<usize>(o) - TOTAL_OVERHEAD).rtSize;
   } else {
-    ERROR("Cannot convert type " + nameof<T>() + " to bytes!");
+    throw new Error("Cannot convert type " + nameof<T>() + " to bytes!");
   }
 }

package/modules/as-bs/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jairus Tanaka <me@jairus.dev>
+
+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/modules/as-bs/README.md

@@ -0,0 +1,95 @@
+<h5 align="center">
+  <pre>
+<span style="font-size: 0.5em;">██████  ██    ██ ███████ ███████ ███████ ██████  ███████ ██ ███    ██ ██   ██ 
+██   ██ ██    ██ ██      ██      ██      ██   ██ ██      ██ ████   ██ ██  ██  
+██████  ██    ██ █████   █████   █████   ██████  ███████ ██ ██ ██  ██ █████   
+██   ██ ██    ██ ██      ██      ██      ██   ██      ██ ██ ██  ██ ██ ██  ██  
+██████   ██████  ██      ██      ███████ ██   ██ ███████ ██ ██   ████ ██   ██ 
+</span>
+    AssemblyScript - v1.0.1
+  </pre>
+</h5>
+
+## About
+
+This library provides a centralized buffer for managing memory in AssemblyScript. It keeps track of a single buffer, the current offset, and handles allocations. Using a singular buffer essentially eliminates the need for any calls to `memory.copy()` as well as any `malloc()` or `realloc()`-type calls. Highly unsafe, but extremely useful for extraordinarily high-performance scenarios.
+
+[This library](https://github.com/JairusSW/as-bs) is what makes [as-json](https://github.com/JairusSW/as-json) operate in the multi-gigabyte-per-second ranges
+
+To take a look at some practical uses of as-bs, check out the functions [here](https://github.com/JairusSW/as-json/tree/master/assembly/serialize/simple)
+
+## Installation
+
+```bash
+npm install as-bs
+```
+
+**🚨 IMPORTANT 🚨**
+
+To make sure we all depend on the same version of as-bs, please modify your package.json to meet the following
+
+Forgoing this will result in fragmentation and just a lot of problems.
+
+```json
+"dependencies": {
+  "as-bs": "latest"
+}
+```
+
+## Usage
+
+Here's an example taken out of [as-json](https://github.com/JairusSW/as-json/tree/master/assembly/serialize/simple/string.ts)
+
+This is an example of as-bs used right
+
+```js
+import { bs } from "as-bs";
+
+function serializeString(src: string): string {
+  const srcSize = bytes(src);
+  bs.ensureSize(srcSize + 4);
+
+  let srcPtr = changetype<usize>(src);
+
+  const srcEnd = srcPtr + srcSize;
+
+  store<u16>(bs.offset, QUOTE);
+
+  bs.offset += 2;
+
+  let lastPtr: i32 = srcPtr;
+  while (srcPtr < srcEnd) {
+    const code = load<u16>(srcPtr);
+    if (code == 34 || code == 92 || code < 32) {
+      const remBytes = srcPtr - lastPtr;
+      memory.copy(bs.offset, lastPtr, remBytes);
+      bs.offset += remBytes;
+      const escaped = load<u32>(SERIALIZE_ESCAPE_TABLE + (code << 2));
+      if ((escaped & 0xffff) != BACK_SLASH) {
+        bs.ensureCapacity(12);
+        store<u64>(bs.offset, 13511005048209500, 0);
+        store<u32>(bs.offset, escaped, 8);
+        bs.offset += 12;
+      } else {
+        bs.ensureCapacity(4);
+        store<u32>(bs.offset, escaped, 0);
+        bs.offset += 4;
+      }
+      lastPtr = srcPtr + 2;
+    }
+    srcPtr += 2;
+  }
+  const remBytes = srcEnd - lastPtr;
+  memory.copy(bs.offset, lastPtr, remBytes);
+  bs.offset += remBytes;
+  store<u16>(bs.offset, QUOTE);
+  bs.offset += 2;
+  return bs.out<string>();
+}
+```
+
+If you use this project in your codebase, consider dropping a [star](https://github.com/JairusSW/as-bs). I would really appreciate it!
+
+## Issues
+
+Please submit an issue to https://github.com/JairusSW/as-bs/issues if you find anything wrong with this library

package/modules/as-bs/assembly/index.ts

@@ -0,0 +1,116 @@
+import { OBJECT, TOTAL_OVERHEAD } from "rt/common";
+
+/**
+ * Central buffer namespace for managing memory operations.
+ */
+export namespace bs {
+  /** Current buffer pointer. */ // @ts-ignore
+  export let buffer: usize = __new(32, idof<ArrayBuffer>());
+
+  /** Current offset within the buffer. */
+  export let offset: usize = buffer;
+
+  /** Byte length of the buffer. */
+  export let byteLength: usize = 32;
+
+  /** Proposed size of output */
+  export let realSize: usize = offset;
+
+  /**
+   * Proposes that the buffer size is should be greater than or equal to the proposed size.
+   * If necessary, reallocates the buffer to the exact new size.
+   * @param size - The size to propose.
+   */
+  // @ts-ignore: Decorator valid here
+  @inline export function proposeSize(size: u32): void {
+    if ((realSize = size) > byteLength) {
+      byteLength = nextPowerOf2(size);
+      // @ts-ignore
+      const newPtr = __renew(buffer, byteLength);
+      offset = offset - buffer + newPtr;
+      buffer = newPtr;
+    }
+  }
+
+  /**
+   * Increases the proposed size by nextPowerOf2(n + 8) if necessary.
+   * If necessary, reallocates the buffer to the exact new size.
+   * @param size - The size to grow by.
+   */
+  // @ts-ignore: Decorator valid here
+  @inline export function growSize(size: u32): void {
+    realSize += size;
+    if (realSize > byteLength) {
+      byteLength += nextPowerOf2(size + 8);
+      // @ts-ignore
+      const newPtr = __renew(buffer, byteLength);
+      offset = offset - buffer + newPtr;
+      buffer = newPtr;
+    }
+  }
+
+  /**
+   * Resizes the buffer to the specified size.
+   * @param newSize - The new buffer size.
+   */
+  // @ts-ignore: Decorator valid here
+  @inline export function resize(newSize: u32): void {
+    // @ts-ignore
+    const newPtr = __renew(buffer, newSize);
+    byteLength = newSize;
+    buffer = newPtr;
+    offset = newPtr + newSize;
+    realSize = newPtr;
+  }
+
+  /**
+   * Copies the buffer's content to a new object of a specified type.
+   * @returns The new object containing the buffer's content.
+   */
+  // @ts-ignore: Decorator valid here
+  @inline export function out<T>(): T {
+    const len = offset - buffer;
+    // @ts-ignore
+    const _out = __new(len, idof<T>());
+    memory.copy(_out, buffer, len);
+
+    offset = buffer;
+    realSize = buffer;
+    return changetype<T>(_out);
+  }
+
+  /**
+   * Copies the buffer's content to a given destination pointer.
+   * Optionally shrinks the buffer after copying.
+   * @param dst - The destination pointer.
+   * @param s - Whether to shrink the buffer after copying.
+   * @returns The destination pointer cast to the specified type.
+   */
+  // @ts-ignore: Decorator valid here
+  @inline export function outTo<T>(dst: usize): T {
+    const len = offset - buffer;
+    // @ts-ignore
+    if (len != changetype<OBJECT>(dst - TOTAL_OVERHEAD).rtSize) __renew(len, idof<T>());
+    memory.copy(dst, buffer, len);
+
+    offset = buffer;
+    realSize = buffer;
+    return changetype<T>(dst);
+  }
+}
+
+// @ts-ignore: Decorator valid here
+@inline function nextPowerOf2(n: u32): u32 {
+  return 1 << (32 - clz(n - 1));
+}
+
+// @ts-ignore: Decorator valid here
+@inline function bytes<T>(o: T): i32 {
+  if (isInteger<T>() || isFloat<T>()) {
+    return sizeof<T>();
+  } else if (isManaged<T>() || isReference<T>()) {
+    return changetype<OBJECT>(changetype<usize>(o) - TOTAL_OVERHEAD).rtSize;
+  } else {
+    throw new Error("Cannot convert type " + nameof<T>() + " to bytes!");
+  }
+}

package/modules/as-bs/assembly/tsconfig.json

@@ -0,0 +1,97 @@
+{
+  "extends": "assemblyscript/std/assembly.json",
+  "include": ["./**/*.ts"],
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+    /* Language and Environment */
+    "target": "es2016" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+    "experimentalDecorators": true /* Enable experimental support for TC39 stage 2 draft decorators. */,
+    "emitDecoratorMetadata": true /* Emit design-type metadata for decorated declarations in source files. */,
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+    /* Modules */
+    "module": "commonjs" /* Specify what module code is generated. */,
+    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+    // "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
+    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "resolveJsonModule": true,                        /* Enable importing .json files. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+    /* Emit */
+    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    // "outDir": "./",                                   /* Specify an output folder for all emitted files. */
+    // "removeComments": true,                           /* Disable emitting comments. */
+    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+    /* Interop Constraints */
+    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
+    /* Type Checking */
+    "strict": false /* Enable all strict type-checking options. */,
+    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+    "strictNullChecks": true /* When type checking, take into account 'null' and 'undefined'. */,
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true, /* Ensure 'use strict' is always emitted. */
+    "noUnusedLocals": true /* Enable error reporting when local variables aren't read. */,
+    "noUnusedParameters": true /* Raise an error when a function parameter isn't read. */,
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+    /* Completeness */
+    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+    "skipLibCheck": true /* Skip type checking all .d.ts files. */
+  }
+}

package/modules/as-bs/index.ts

@@ -0,0 +1 @@
+export { bs } from "./assembly/index";

package/modules/as-bs/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "as-bs",
+  "version": "1.0.1",
+  "description": "Near zero-alloc centralized buffer for high performance applications",
+  "types": "assembly/index.ts",
+  "author": "Jairus Tanaka",
+  "contributors": [],
+  "license": "MIT",
+  "scripts": {},
+  "devDependencies": {
+    "assemblyscript": "^0.27.31"
+  },
+  "dependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JairusSW/as-bs.git"
+  },
+  "keywords": [
+    "assemblyscript",
+    "fast",
+    "memory",
+    "buffer"
+  ],
+  "bugs": {
+    "url": "https://github.com/JairusSW/as-bs/issues"
+  },
+  "homepage": "https://github.com/JairusSW/as-bs#readme",
+  "type": "module",
+  "publishConfig": {
+    "@JairusSW:registry": "https://npm.pkg.github.com"
+  }
+}

package/modules/test/assembly/index.ts

@@ -0,0 +1,22 @@
+export function describe(description: string, routine: () => void): void {
+  routine();
+}
+
+export function expect(left: string): Expectation {
+  return new Expectation(left);
+}
+
+class Expectation {
+  public left: string;
+
+  constructor(left: string) {
+    this.left = left;
+  }
+  toBe(right: string): void {
+    if (this.left != right) {
+      console.log("  (expected) -> " + right);
+      console.log("  (received) -> " + this.left);
+      process.exit(1);
+    }
+  }
+}