@natoboram/based.ts 0.0.1 → 0.0.2

package/README.md

@@ -2,7 +2,22 @@
 
 [![GitHub Pages](https://github.com/NatoBoram/based.ts/actions/workflows/github-pages.yaml/badge.svg)](https://github.com/NatoBoram/based.ts/actions/workflows/github-pages.yaml) [![Node.js CI](https://github.com/NatoBoram/based.ts/actions/workflows/node.js.yaml/badge.svg)](https://github.com/NatoBoram/based.ts/actions/workflows/node.js.yaml)
 
-Change between bases.
+A TypeScript library for working with arbitrary bases.
+
+## Installation
+
+It can be installed globally if you want to generate base36-encoded UUIDs.
+
+```sh
+pnpm install --global @natoboram/based.ts
+basedts
+```
+
+```log
+Base 36 UUID: 2pcugbwbg50o24pnu8h3u1f0b
+```
+
+Proper CLI options are planned for the future, but for now that's all I needed this package for.
 
 ## Usage
 
@@ -11,8 +26,19 @@ pnpm i -D @natoboram/based.ts
 ```
 
 ```ts
-import { base36Uuid } from "@natoboram/based.ts"
+import {
+	basedToBigInt,
+	bytesToBigInt,
+	getRandomBytes,
+	toBase,
+} from "@natoboram/based.ts"
+
+// Generate a base36-encoded UUID
+const bytes = getRandomBytes()
+const bigInt = bytesToBigInt(bytes)
+const base36 = toBase(bigInt, 36n)
+console.log("Base 36 UUID:", base36)
 
-const uuid = base36Uuid()
-console.log("Base 36 UUID:", uuid)
+// Convert between two bases
+const base64 = toBase(basedToBigInt("20zsnycqen1k898slr7xgnc9t", 36n), 64n)
 ```

package/dist/based.d.ts

@@ -0,0 +1,14 @@
+/** Base-encoded string. Use this class if you convert from and to different
+ * bases often. Otherwise, just use the provided utilities. You can provide a custom number's space */
+export declare class Based {
+    readonly value: string;
+    readonly base: bigint;
+    readonly space: string;
+    constructor(value: string, base: bigint, space?: string);
+    divide(based: Based): Based;
+    minus(based: Based): Based;
+    multiply(based: Based): Based;
+    plus(based: Based): Based;
+    to(base: bigint, space?: string): Based;
+}
+//# sourceMappingURL=based.d.ts.map

package/dist/based.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"based.d.ts","sourceRoot":"","sources":["../src/based.ts"],"names":[],"mappings":"AAIA;sGACsG;AACtG,qBAAa,KAAK;IAEhB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,KAAK;gBAFL,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,SAAc;IAG7B,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAO3B,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAO1B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAO7B,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAOzB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK;CAKvC"}

package/dist/based.js

@@ -0,0 +1,45 @@
+import { base64Space } from "./space.js";
+import { toBase } from "./to_base.js";
+import { basedToBigInt } from "./to_bigint.js";
+/** Base-encoded string. Use this class if you convert from and to different
+ * bases often. Otherwise, just use the provided utilities. You can provide a custom number's space */
+export class Based {
+    value;
+    base;
+    space;
+    constructor(value, base, space = base64Space) {
+        this.value = value;
+        this.base = base;
+        this.space = space;
+    }
+    divide(based) {
+        const dividend = basedToBigInt(this.value, this.base, this.space);
+        const divisor = basedToBigInt(based.value, based.base, based.space);
+        const quotient = dividend / divisor;
+        return new Based(toBase(quotient, this.base, this.space), this.base);
+    }
+    minus(based) {
+        const minuend = basedToBigInt(this.value, this.base, this.space);
+        const subtrahend = basedToBigInt(based.value, based.base, based.space);
+        const difference = minuend - subtrahend;
+        return new Based(toBase(difference, this.base, this.space), this.base);
+    }
+    multiply(based) {
+        const multiplier = basedToBigInt(this.value, this.base, this.space);
+        const multiplicand = basedToBigInt(based.value, based.base, based.space);
+        const product = multiplier * multiplicand;
+        return new Based(toBase(product, this.base, this.space), this.base);
+    }
+    plus(based) {
+        const augend = basedToBigInt(this.value, this.base, this.space);
+        const addend = basedToBigInt(based.value, based.base, based.space);
+        const sum = augend + addend;
+        return new Based(toBase(sum, this.base, this.space), this.base);
+    }
+    to(base, space) {
+        const bigInt = basedToBigInt(this.value, this.base, this.space);
+        const value = toBase(bigInt, base, space);
+        return new Based(value, base, space);
+    }
+}
+//# sourceMappingURL=based.js.map

package/dist/based.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"based.js","sourceRoot":"","sources":["../src/based.ts"],"names":[],"mappings":"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"}

package/dist/bytes.d.ts

@@ -0,0 +1,4 @@
+/** Get a randomized selection of bytes from `crypto`. By default, get 128 bits,
+ * a UUID's worth of bytes. */
+export declare function getRandomBytes(length?: number): Uint8ClampedArray;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAAA;8BAC8B;AAC9B,wBAAgB,cAAc,CAAC,MAAM,SAAK,qBAIzC"}

package/dist/bytes.js

@@ -0,0 +1,8 @@
+/** Get a randomized selection of bytes from `crypto`. By default, get 128 bits,
+ * a UUID's worth of bytes. */
+export function getRandomBytes(length = 16) {
+    const bytes = new Uint8ClampedArray(length);
+    crypto.getRandomValues(bytes);
+    return bytes;
+}
+//# sourceMappingURL=bytes.js.map

package/dist/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAAA;8BAC8B;AAC9B,MAAM,UAAU,cAAc,CAAC,MAAM,GAAG,EAAE;IACzC,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC7B,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,8 @@
-export * from "./base36-uuid.js";
+export * from "./based.js";
+export * from "./bytes.js";
+export * from "./space.js";
+export * from "./to_base.js";
+export * from "./to_bigint.js";
+export * from "./to_bytes.js";
+export * from "./typed_array.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -1,2 +1,8 @@
-export * from "./base36-uuid.js";
+export * from "./based.js";
+export * from "./bytes.js";
+export * from "./space.js";
+export * from "./to_base.js";
+export * from "./to_bigint.js";
+export * from "./to_bytes.js";
+export * from "./typed_array.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/dist/main.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
-import { base36Uuid } from "./base36-uuid.js";
-const uuid = base36Uuid();
-console.log("Base 36 UUID:", uuid);
+import { bytesToBigInt, getRandomBytes, toBase } from "./index.js";
+const bytes = getRandomBytes();
+const bigInt = bytesToBigInt(bytes);
+const base36 = toBase(bigInt, 36n);
+console.log("Base 36 UUID:", base36);
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAA;AACzB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAElE,MAAM,KAAK,GAAG,cAAc,EAAE,CAAA;AAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAElC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA"}

package/dist/space.d.ts

@@ -0,0 +1,3 @@
+/** Default number space for this package. */
+export declare const base64Space = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/";
+//# sourceMappingURL=space.d.ts.map

package/dist/space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../src/space.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,eAAO,MAAM,WAAW,qEAC2C,CAAA"}

package/dist/space.js

@@ -0,0 +1,3 @@
+/** Default number space for this package. */
+export const base64Space = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/";
+//# sourceMappingURL=space.js.map

package/dist/space.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.js","sourceRoot":"","sources":["../src/space.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GACvB,kEAAkE,CAAA"}

package/dist/to_base.d.ts

@@ -0,0 +1,3 @@
+/** Convert a number to a string in a given base. */
+export declare function toBase(value: bigint, base: bigint, space?: string): string;
+//# sourceMappingURL=to_base.d.ts.map

package/dist/to_base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_base.d.ts","sourceRoot":"","sources":["../src/to_base.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,wBAAgB,MAAM,CACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,SAAc,GACjB,MAAM,CAgBR"}

package/dist/to_base.js

@@ -0,0 +1,18 @@
+import { base64Space } from "./space.js";
+/** Convert a number to a string in a given base. */
+export function toBase(value, base, space = base64Space) {
+    if (space.length < Number(base))
+        throw new Error("Invalid space for this base", {
+            cause: { value, base, space },
+        });
+    if (value < 0n)
+        return `-${toBase(-value, base, space)}`;
+    let result = "";
+    while (value) {
+        const digit = Number(value % base);
+        value /= base;
+        result = space[digit] + result;
+    }
+    return result;
+}
+//# sourceMappingURL=to_base.js.map

package/dist/to_base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_base.js","sourceRoot":"","sources":["../src/to_base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,oDAAoD;AACpD,MAAM,UAAU,MAAM,CACrB,KAAa,EACb,IAAY,EACZ,KAAK,GAAG,WAAW;IAEnB,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE;YAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;SAC7B,CAAC,CAAA;IAEH,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAA;IAExD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,OAAO,KAAK,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;QAClC,KAAK,IAAI,IAAI,CAAA;QACb,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;IAC/B,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/to_bigint.d.ts

@@ -0,0 +1,9 @@
+import type { TypedUintArray } from "./typed_array.js";
+/** Turns a `string` in a given `base` into a `bigint` by multiplying each digit
+ * by the `base` raised to the power of its position in the `string`. */
+export declare function basedToBigInt(based: string, base: bigint, space?: string): bigint;
+/** Turns a typed `uint` array into a `bigint` by converting each `uint` into a
+ * hexadecimal string then concatenating the resulting digits using JavaScript's
+ * `0x` notation. */
+export declare function bytesToBigInt(typedArray: TypedUintArray): bigint;
+//# sourceMappingURL=to_bigint.d.ts.map

package/dist/to_bigint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_bigint.d.ts","sourceRoot":"","sources":["../src/to_bigint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;wEACwE;AACxE,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,SAAc,GACjB,MAAM,CAuBR;AAED;;oBAEoB;AACpB,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAUhE"}

package/dist/to_bigint.js

@@ -0,0 +1,32 @@
+import { base64Space } from "./space.js";
+/** Turns a `string` in a given `base` into a `bigint` by multiplying each digit
+ * by the `base` raised to the power of its position in the `string`. */
+export function basedToBigInt(based, base, space = base64Space) {
+    space = space.slice(0, Number(base));
+    if (space.length < Number(base))
+        throw new Error("Invalid space for this base", {
+            cause: { based, base, space },
+        });
+    if (base <= 36)
+        based = based.toLowerCase();
+    if (based.startsWith("-"))
+        return -basedToBigInt(based.slice(1), base, space);
+    return Array.from(based).reduce((result, digit, digitIndex) => {
+        const spaceIndex = space.indexOf(digit);
+        if (spaceIndex == -1)
+            throw new Error("Invalid digit for this space", {
+                cause: { based, base, space, result, digit, digitIndex, spaceIndex },
+            });
+        return (result +
+            BigInt(spaceIndex) * base ** BigInt(based.length - 1 - digitIndex));
+    }, 0n);
+}
+/** Turns a typed `uint` array into a `bigint` by converting each `uint` into a
+ * hexadecimal string then concatenating the resulting digits using JavaScript's
+ * `0x` notation. */
+export function bytesToBigInt(typedArray) {
+    const maxLength = typedArray.BYTES_PER_ELEMENT * 2;
+    const hexes = Array.from(typedArray).reduce((hexes, value) => (hexes.push(value.toString(16).padStart(maxLength, "0")), hexes), new Array(typedArray.length));
+    return BigInt(`0x${hexes.join("")}`);
+}
+//# sourceMappingURL=to_bigint.js.map

package/dist/to_bigint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_bigint.js","sourceRoot":"","sources":["../src/to_bigint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC;wEACwE;AACxE,MAAM,UAAU,aAAa,CAC5B,KAAa,EACb,IAAY,EACZ,KAAK,GAAG,WAAW;IAEnB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAEpC,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE;YAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;SAC7B,CAAC,CAAA;IAEH,IAAI,IAAI,IAAI,EAAE;QAAE,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IAC3C,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAE7E,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAS,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;QACrE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,UAAU,IAAI,CAAC,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE;gBAC/C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE;aACpE,CAAC,CAAA;QAEH,OAAO,CACN,MAAM;YACN,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAClE,CAAA;IACF,CAAC,EAAE,EAAE,CAAC,CAAA;AACP,CAAC;AAED;;oBAEoB;AACpB,MAAM,UAAU,aAAa,CAAC,UAA0B;IACvD,MAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,GAAG,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAC1C,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,CAC9D,EACD,IAAI,KAAK,CAAS,UAAU,CAAC,MAAM,CAAC,CACpC,CAAA;IAED,OAAO,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACrC,CAAC"}

package/dist/to_bytes.d.ts

@@ -0,0 +1,4 @@
+/** Turns a `bigint` into a `Uint8ClampedArray` by converting it to a
+ * hexadecimal string then turning each digit into a pair of bytes. */
+export declare function bigIntToBytes(bigInt: bigint): Uint8ClampedArray;
+//# sourceMappingURL=to_bytes.d.ts.map

package/dist/to_bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_bytes.d.ts","sourceRoot":"","sources":["../src/to_bytes.ts"],"names":[],"mappings":"AAAA;sEACsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAa/D"}

package/dist/to_bytes.js

@@ -0,0 +1,15 @@
+/** Turns a `bigint` into a `Uint8ClampedArray` by converting it to a
+ * hexadecimal string then turning each digit into a pair of bytes. */
+export function bigIntToBytes(bigInt) {
+    let hexes = bigInt.toString(16);
+    if (hexes.length % 2)
+        hexes = `0${hexes}`;
+    const length = hexes.length / 2;
+    const bytes = new Uint8ClampedArray(length);
+    for (let index = 0; index < length; index++) {
+        const hex = hexes.slice(index * 2, index * 2 + 2);
+        bytes[index] = parseInt(hex, 16);
+    }
+    return bytes;
+}
+//# sourceMappingURL=to_bytes.js.map

package/dist/to_bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_bytes.js","sourceRoot":"","sources":["../src/to_bytes.ts"],"names":[],"mappings":"AAAA;sEACsE;AACtE,MAAM,UAAU,aAAa,CAAC,MAAc;IAC3C,IAAI,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IAEzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IAC/B,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAE3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACjD,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/typed_array.d.ts

@@ -0,0 +1,2 @@
+export type TypedUintArray = Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array;
+//# sourceMappingURL=typed_array.d.ts.map

package/dist/typed_array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed_array.d.ts","sourceRoot":"","sources":["../src/typed_array.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACvB,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,WAAW,CAAA"}

package/dist/typed_array.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typed_array.js.map

package/dist/typed_array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed_array.js","sourceRoot":"","sources":["../src/typed_array.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@natoboram/based.ts",
-  "version": "0.0.1",
-  "description": "Change between bases",
+  "version": "0.0.2",
+  "description": "A TypeScript library for working with arbitrary bases",
   "keywords": [
+    "base2",
+    "base10",
+    "base16",
     "base36",
+    "base62",
+    "base64",
     "uuid"
   ],
   "homepage": "https://github.com/NatoBoram/based.ts",

package/dist/base36-uuid.d.ts

@@ -1,8 +0,0 @@
-export declare function stringToBits(str: string): Uint8Array;
-export declare function get128Bits(): Uint8ClampedArray;
-export declare function bytesToBigInt(bytes: Uint8ClampedArray): bigint;
-export declare function bigIntToBytes(bn: bigint): Uint8ClampedArray;
-export declare function bigIntToBase36(bigInt: bigint): string;
-export declare function base36ToBigInt(base36: string): bigint;
-export declare function base36Uuid(): string;
-//# sourceMappingURL=base36-uuid.d.ts.map

package/dist/base36-uuid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base36-uuid.d.ts","sourceRoot":"","sources":["../src/base36-uuid.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,cAEvC;AAED,wBAAgB,UAAU,sBAIzB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,UAWrD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,qBAavC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,UAE5C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,UAK5C;AAED,wBAAgB,UAAU,WAKzB"}

package/dist/base36-uuid.js

@@ -1,43 +0,0 @@
-export function stringToBits(str) {
-    return new TextEncoder().encode(str);
-}
-export function get128Bits() {
-    const bytes = new Uint8ClampedArray(16);
-    crypto.getRandomValues(bytes);
-    return bytes;
-}
-export function bytesToBigInt(bytes) {
-    const hexes = bytes.reduce((hexes, byte) => {
-        /** A single hexadecimal number. Because the byte is 8 bits, the hex ranges
-         * from `00` to `FF`. */
-        const hex = byte.toString(16).padStart(2, "0");
-        hexes.push(hex);
-        return hexes;
-    }, new Array(16));
-    return BigInt(`0x${hexes.join("")}`);
-}
-export function bigIntToBytes(bn) {
-    let hexes = bn.toString(16);
-    if (hexes.length % 2)
-        hexes = `0${hexes}`;
-    const length = hexes.length / 2;
-    const bytes = new Uint8ClampedArray(length);
-    for (let index = 0; index < length; index++) {
-        const hex = hexes.slice(index * 2, index * 2 + 2);
-        bytes[index] = parseInt(hex, 16);
-    }
-    return bytes;
-}
-export function bigIntToBase36(bigInt) {
-    return bigInt.toString(36);
-}
-export function base36ToBigInt(base36) {
-    return Array.from(base36).reduce((bigInt, digit) => bigInt * 36n + BigInt(parseInt(digit, 36)), 0n);
-}
-export function base36Uuid() {
-    const bytes = get128Bits();
-    const bigInt = bytesToBigInt(bytes);
-    const base36 = bigIntToBase36(bigInt);
-    return base36;
-}
-//# sourceMappingURL=base36-uuid.js.map

package/dist/base36-uuid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base36-uuid.js","sourceRoot":"","sources":["../src/base36-uuid.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,GAAW;IACvC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,EAAE,CAAC,CAAA;IACvC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC7B,OAAO,KAAK,CAAA;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAwB;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC1C;gCACwB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAE9C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACf,OAAO,KAAK,CAAA;IACb,CAAC,EAAE,IAAI,KAAK,CAAS,EAAE,CAAC,CAAC,CAAA;IAEzB,OAAO,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACvC,IAAI,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IAEzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IAC/B,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAE3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACjD,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAC/B,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAC7D,EAAE,CACF,CAAA;AACF,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IACrC,OAAO,MAAM,CAAA;AACd,CAAC"}