@natoboram/based.ts 0.0.3 → 1.0.0

package/README.md

@@ -1,44 +1,67 @@
-# `based.ts`
+# [`@natoboram/based.ts`](https://github.com/NatoBoram/based.ts)
 
-[![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) [![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) [![GitHub Downloads](https://img.shields.io/github/downloads/NatoBoram/based.ts/total?logo=github)](https://github.com/NatoBoram/based.ts/releases) [![NPM Downloads](https://img.shields.io/npm/dt/%40natoboram/based.ts?logo=npm)](https://www.npmjs.com/package/@natoboram/based.ts) [![Dependabot Updates](https://github.com/NatoBoram/based.ts/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/NatoBoram/based.ts/actions/workflows/dependabot/dependabot-updates)
+[![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) [![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) [![GitHub Downloads](https://img.shields.io/github/downloads/NatoBoram/based.ts/total?logo=github)](https://github.com/NatoBoram/based.ts/releases) [![NPM Downloads](https://img.shields.io/npm/dt/%40natoboram/based.ts?logo=npm)](https://www.npmjs.com/package/@natoboram/based.ts) [![Dependabot Updates](https://github.com/NatoBoram/based.ts/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/NatoBoram/based.ts/actions/workflows/dependabot/dependabot-updates) [![Wakapi](https://wakapi.dev/api/badge/NatoBoram/interval:any/project:based.ts)](https://wakapi.dev/summary?interval=any&project=based.ts)
 
 A TypeScript library for working with arbitrary bases.
 
-## Installation
+## CLI
 
-It can be installed globally if you want to generate base36-encoded UUIDs.
+It can be installed globally if you want to convert numbers or generate UUIDs from the terminal.
 
 ```sh
 pnpm install --global @natoboram/based.ts
-basedts
 ```
 
 ```log
-Base 36 UUID: 2pcugbwbg50o24pnu8h3u1f0b
+Usage: basedts convert [options] <number>
+
+Convert a number from a base in a space to another base in another space
+
+Arguments:
+  number                The number to convert
+
+Options:
+  --from-base <base>    The base of the number (default: "10")
+  --from-space <space>  The space of the number to convert from (default: "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/")
+  --to-base <base>      The base to convert to (default: "10")
+  --to-space <space>    The space to convert the number to (default: "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/")
+  -h, --help            Display help for command
 ```
 
-Proper CLI options are planned for the future, but for now that's all I needed this package for.
+```log
+Usage: basedts uuid [options]
+
+Generate a UUID in a different base with a different space than normal UUIDs
+
+Options:
+  --base <base>    The base of the UUID to generate (default: "16")
+  --space <space>  The space of the UUID to generate (default: "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/")
+  -h, --help       Display help for command
+```
 
-## Usage
+## Library
 
 ```sh
-pnpm i -D @natoboram/based.ts
+pnpm install @natoboram/based.ts
 ```
 
 ```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)
+import { toBase, basedToBigInt } from "@natoboram/based.ts"
 
 // Convert between two bases
-const base64 = toBase(basedToBigInt("20zsnycqen1k898slr7xgnc9t", 36n), 64n)
+const bigInt = basedToBigInt("69", 10n)
+const based = toBase(bigInt, 16n)
+
+console.log(based) // 45
+```
+
+```ts
+import { Based } from "@natoboram/based.ts"
+
+// Perform operations on numbers of different bases
+const four = new Based("4", 64n)
+const two = new Based("2", 16n)
+const result = four.divide(two).to(10n)
+
+console.log(result.value) // 2
 ```

package/dist/based.d.ts

@@ -5,6 +5,8 @@ export declare class Based {
     readonly base: bigint;
     readonly space: string;
     constructor(value: string, base: bigint, space?: string);
+    static fromUtf8(value: string, base?: bigint, space?: string): Based;
+    toUtf8(): string;
     divide(based: Based): Based;
     minus(based: Based): Based;
     multiply(based: Based): Based;

package/dist/based.d.ts.map

@@ -1 +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,EAAE,MAAM;gBAFb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB;IAGrC,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"}
+{"version":3,"file":"based.d.ts","sourceRoot":"","sources":["../src/based.ts"],"names":[],"mappings":"AAKA;sGACsG;AACtG,qBAAa,KAAK;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;gBAEV,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAoB;IAMpE,MAAM,CAAC,QAAQ,CACd,KAAK,EAAE,MAAM,EACb,IAAI,SAAM,EACV,KAAK,GAAE,MAAoB,GACzB,KAAK;IAKR,MAAM,IAAI,MAAM;IAIhB,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

@@ -1,6 +1,7 @@
 import { base64Space } from "./space.js";
-import { toBase } from "./to_base.js";
+import { toBase, utf8ToBase } from "./to_base.js";
 import { basedToBigInt } from "./to_bigint.js";
+import { basedToUtf8 } from "./to_utf-8.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 {
@@ -12,6 +13,13 @@ export class Based {
         this.base = base;
         this.space = space;
     }
+    static fromUtf8(value, base = 10n, space = base64Space) {
+        const based = utf8ToBase(value, base, space);
+        return new Based(based, base, space);
+    }
+    toUtf8() {
+        return basedToUtf8(this.value, this.base, this.space);
+    }
     divide(based) {
         const dividend = basedToBigInt(this.value, this.base, this.space);
         const divisor = basedToBigInt(based.value, based.base, based.space);

package/dist/based.js.map

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

package/dist/commander/convert.d.ts

@@ -0,0 +1,9 @@
+interface ConvertOptions {
+    readonly fromBase: string;
+    readonly fromSpace: string;
+    readonly toBase: string;
+    readonly toSpace: string;
+}
+export declare function convert(input: string, options: ConvertOptions): void;
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/commander/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/commander/convert.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAkBD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAOpE"}

package/dist/commander/convert.js

@@ -0,0 +1,16 @@
+import { toBase } from "../to_base.js";
+import { basedToBigInt } from "../to_bigint.js";
+function parseConvertOptions(options) {
+    const fromBase = BigInt(parseInt(options.fromBase));
+    const toBase = BigInt(parseInt(options.toBase));
+    const fromSpace = options.fromSpace;
+    const toSpace = options.toSpace;
+    return { fromBase, fromSpace, toBase, toSpace };
+}
+export function convert(input, options) {
+    const parsed = parseConvertOptions(options);
+    const bigInt = basedToBigInt(input, parsed.fromBase, parsed.fromSpace);
+    const based = toBase(bigInt, parsed.toBase, parsed.toSpace);
+    console.log(based);
+}
+//# sourceMappingURL=convert.js.map

package/dist/commander/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/commander/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAgB/C,SAAS,mBAAmB,CAAC,OAAuB;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAE/B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,OAAuB;IAC7D,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAE3C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAE3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC"}

package/dist/commander/program.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare const program: Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/commander/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/commander/program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAcxC,eAAO,MAAM,OAAO,EAAE,OAAyB,CAAA"}

package/dist/commander/program.js

@@ -0,0 +1,28 @@
+import { createCommand } from "commander";
+import pkg from "../../package.json" with { type: "json" };
+import { base64Space } from "../space.js";
+import { convert } from "./convert.js";
+import { uuid } from "./uuid.js";
+const { bin, version, description } = pkg;
+const name = Object.keys(bin).find(Boolean);
+if (!name) {
+    throw new Error("No executable name found in package.json");
+}
+export const program = createCommand();
+program.name(name).description(description).version(version);
+program
+    .command("convert")
+    .description("Convert a number from a base in a space to another base in another space")
+    .argument("<number>", "The number to convert")
+    .option("--from-base <base>", "The base of the number", "10")
+    .option("--from-space <space>", "The space of the number to convert from", base64Space)
+    .option("--to-base <base>", "The base to convert to", "10")
+    .option("--to-space <space>", "The space to convert the number to", base64Space)
+    .action(convert);
+program
+    .command("uuid")
+    .description("Generate a UUID in a different base with a different space than normal UUIDs")
+    .option("--base <base>", "The base of the UUID to generate", "16")
+    .option("--space <space>", "The space of the UUID to generate", base64Space)
+    .action(uuid);
+//# sourceMappingURL=program.js.map

package/dist/commander/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/commander/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,GAAG,CAAA;AAEzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;IACX,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAY,aAAa,EAAE,CAAA;AAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAE5D,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CACX,0EAA0E,CAC1E;KACA,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;KAC7C,MAAM,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,IAAI,CAAC;KAC5D,MAAM,CACN,sBAAsB,EACtB,yCAAyC,EACzC,WAAW,CACX;KACA,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,IAAI,CAAC;KAC1D,MAAM,CACN,oBAAoB,EACpB,oCAAoC,EACpC,WAAW,CACX;KACA,MAAM,CAAC,OAAO,CAAC,CAAA;AAEjB,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CACX,8EAA8E,CAC9E;KACA,MAAM,CAAC,eAAe,EAAE,kCAAkC,EAAE,IAAI,CAAC;KACjE,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,WAAW,CAAC;KAC3E,MAAM,CAAC,IAAI,CAAC,CAAA"}

package/dist/commander/uuid.d.ts

@@ -0,0 +1,7 @@
+interface UuidOptions {
+    readonly base: string;
+    readonly space: string;
+}
+export declare function uuid(options: UuidOptions): void;
+export {};
+//# sourceMappingURL=uuid.d.ts.map

package/dist/commander/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/commander/uuid.ts"],"names":[],"mappings":"AAGA,UAAU,WAAW;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAaD,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAO/C"}

package/dist/commander/uuid.js

@@ -0,0 +1,14 @@
+import { getRandomBytes } from "../bytes.js";
+import { bytesToBase } from "../to_base.js";
+function parseUuidOptions(options) {
+    const base = BigInt(parseInt(options.base));
+    const space = options.space;
+    return { base, space };
+}
+export function uuid(options) {
+    const parsed = parseUuidOptions(options);
+    const bytes = getRandomBytes(16);
+    const based = bytesToBase(bytes, parsed.base, parsed.space);
+    console.log(based);
+}
+//# sourceMappingURL=uuid.js.map

package/dist/commander/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/commander/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAY3C,SAAS,gBAAgB,CAAC,OAAoB;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAoB;IACxC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAExC,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IAE3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-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";
+export * from "./based.ts";
+export * from "./bytes.ts";
+export * from "./space.ts";
+export * from "./to_base.ts";
+export * from "./to_bigint.ts";
+export * from "./to_bytes.ts";
+export * from "./to_utf-8.ts";
+export type * from "./typed_array.ts";
 //# 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,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"}
+{"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,eAAe,CAAA;AAC7B,mBAAmB,kBAAkB,CAAA"}

package/dist/index.js

@@ -4,5 +4,5 @@ export * from "./space.js";
 export * from "./to_base.js";
 export * from "./to_bigint.js";
 export * from "./to_bytes.js";
-export * from "./typed_array.js";
+export * from "./to_utf-8.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,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"}
+{"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,eAAe,CAAA"}

package/dist/main.js

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-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);
+import { program } from "./commander/program.js";
+program.parse(process.argv);
 //# 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,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"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/space.d.ts

@@ -1,3 +1,5 @@
-/** Default number space for this package. */
+/** Default number space for this package. It should match `Number.toString` for
+ * the first 36 characters. The rest is filled with the uppercase alphabet then
+ * the standard, most common base64 letters, `+` and `/`. */
 export declare const base64Space = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/";
 //# sourceMappingURL=space.d.ts.map

package/dist/space.d.ts.map

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

package/dist/space.js

@@ -1,3 +1,5 @@
-/** Default number space for this package. */
+/** Default number space for this package. It should match `Number.toString` for
+ * the first 36 characters. The rest is filled with the uppercase alphabet then
+ * the standard, most common base64 letters, `+` and `/`. */
 export const base64Space = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/";
 //# sourceMappingURL=space.js.map

package/dist/space.js.map

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

package/dist/to_base.d.ts

@@ -1,3 +1,7 @@
+import type { TypedUintArray } from "./typed_array.ts";
 /** Convert a number to a string in a given base. */
 export declare function toBase(value: bigint, base: bigint, space?: string): string;
+/** Convert a UTF-8 string to a number in a given base. */
+export declare function utf8ToBase(value: string, base: bigint, space?: string): string;
+export declare function bytesToBase(bytes: TypedUintArray, base: bigint, space?: string): string;
 //# sourceMappingURL=to_base.d.ts.map

package/dist/to_base.d.ts.map

@@ -1 +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,GAAE,MAAoB,GACzB,MAAM,CAuBR"}
+{"version":3,"file":"to_base.d.ts","sourceRoot":"","sources":["../src/to_base.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,oDAAoD;AACpD,wBAAgB,MAAM,CACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB,GACzB,MAAM,CAuBR;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB,GACzB,MAAM,CAGR;AAED,wBAAgB,WAAW,CAC1B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB,GACzB,MAAM,CAGR"}

package/dist/to_base.js

@@ -1,4 +1,5 @@
 import { base64Space } from "./space.js";
+import { bytesToBigInt, utf8ToBigInt } from "./to_bigint.js";
 /** Convert a number to a string in a given base. */
 export function toBase(value, base, space = base64Space) {
     if (space.length < Number(base))
@@ -20,4 +21,13 @@ export function toBase(value, base, space = base64Space) {
     }
     return result;
 }
+/** Convert a UTF-8 string to a number in a given base. */
+export function utf8ToBase(value, base, space = base64Space) {
+    const bigInt = utf8ToBigInt(value);
+    return toBase(bigInt, base, space);
+}
+export function bytesToBase(bytes, base, space = base64Space) {
+    const bigInt = bytesToBigInt(bytes);
+    return toBase(bigInt, base, space);
+}
 //# sourceMappingURL=to_base.js.map

package/dist/to_base.js.map

@@ -1 +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,QAAgB,WAAW;IAE3B,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;QAEb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS;YACtB,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE;gBAChC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;aAC5C,CAAC,CAAA;QAEH,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC"}
+{"version":3,"file":"to_base.js","sourceRoot":"","sources":["../src/to_base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG5D,oDAAoD;AACpD,MAAM,UAAU,MAAM,CACrB,KAAa,EACb,IAAY,EACZ,QAAgB,WAAW;IAE3B,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;QAEb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS;YACtB,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE;gBAChC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;aAC5C,CAAC,CAAA;QAEH,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CACzB,KAAa,EACb,IAAY,EACZ,QAAgB,WAAW;IAE3B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAC1B,KAAqB,EACrB,IAAY,EACZ,QAAgB,WAAW;IAE3B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC"}

package/dist/to_bigint.d.ts

@@ -1,4 +1,4 @@
-import type { TypedUintArray } from "./typed_array.js";
+import type { TypedUintArray } from "./typed_array.ts";
 /** 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;
@@ -6,4 +6,5 @@ export declare function basedToBigInt(based: string, base: bigint, space?: strin
  * hexadecimal string then concatenating the resulting digits using JavaScript's
  * `0x` notation. */
 export declare function bytesToBigInt(typedArray: TypedUintArray): bigint;
+export declare function utf8ToBigInt(value: string): bigint;
 //# sourceMappingURL=to_bigint.d.ts.map

package/dist/to_bigint.d.ts.map

@@ -1 +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,GAAE,MAAoB,GACzB,MAAM,CAuBR;AAED;;oBAEoB;AACpB,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAUhE"}
+{"version":3,"file":"to_bigint.d.ts","sourceRoot":"","sources":["../src/to_bigint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;wEACwE;AACxE,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB,GACzB,MAAM,CAuBR;AAED;;oBAEoB;AACpB,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAUhE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/to_bigint.js

@@ -1,4 +1,5 @@
 import { base64Space } from "./space.js";
+import { utf8ToBytes } from "./to_bytes.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) {
@@ -29,4 +30,8 @@ export function bytesToBigInt(typedArray) {
     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("")}`);
 }
+export function utf8ToBigInt(value) {
+    const bytes = utf8ToBytes(value);
+    return bytesToBigInt(bytes);
+}
 //# sourceMappingURL=to_bigint.js.map

package/dist/to_bigint.js.map

@@ -1 +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,QAAgB,WAAW;IAE3B,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"}
+{"version":3,"file":"to_bigint.js","sourceRoot":"","sources":["../src/to_bigint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C;wEACwE;AACxE,MAAM,UAAU,aAAa,CAC5B,KAAa,EACb,IAAY,EACZ,QAAgB,WAAW;IAE3B,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;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC"}

package/dist/to_bytes.d.ts

@@ -1,4 +1,6 @@
 /** 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;
+export declare function utf8ToBytes(value: string): Uint8Array;
+export declare function basedToBytes(based: string, base: bigint, space?: string): Uint8ClampedArray;
 //# sourceMappingURL=to_bytes.d.ts.map

package/dist/to_bytes.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"to_bytes.d.ts","sourceRoot":"","sources":["../src/to_bytes.ts"],"names":[],"mappings":"AAGA;sEACsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAa/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAGrD;AAED,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB,GACzB,iBAAiB,CAGnB"}

package/dist/to_bytes.js

@@ -1,3 +1,5 @@
+import { base64Space } from "./space.js";
+import { basedToBigInt } from "./to_bigint.js";
 /** 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) {
@@ -12,4 +14,12 @@ export function bigIntToBytes(bigInt) {
     }
     return bytes;
 }
+export function utf8ToBytes(value) {
+    const encoder = new TextEncoder();
+    return encoder.encode(value);
+}
+export function basedToBytes(based, base, space = base64Space) {
+    const bigInt = basedToBigInt(based, base, space);
+    return bigIntToBytes(bigInt);
+}
 //# sourceMappingURL=to_bytes.js.map

package/dist/to_bytes.js.map

@@ -1 +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"}
+{"version":3,"file":"to_bytes.js","sourceRoot":"","sources":["../src/to_bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C;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;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,KAAa,EACb,IAAY,EACZ,QAAgB,WAAW;IAE3B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAChD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC"}

package/dist/to_utf-8.d.ts

@@ -0,0 +1,5 @@
+import type { TypedUintArray } from "./typed_array.ts";
+export declare function basedToUtf8(based: string, base: bigint, space?: string): string;
+export declare function bigIntToUtf8(bigInt: bigint): string;
+export declare function bytesToUtf8(bytes: TypedUintArray): string;
+//# sourceMappingURL=to_utf-8.d.ts.map

package/dist/to_utf-8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_utf-8.d.ts","sourceRoot":"","sources":["../src/to_utf-8.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,wBAAgB,WAAW,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAoB,GACzB,MAAM,CAIR;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAGzD"}

package/dist/to_utf-8.js

@@ -0,0 +1,17 @@
+import { base64Space } from "./space.js";
+import { basedToBytes, bigIntToBytes } from "./to_bytes.js";
+export function basedToUtf8(based, base, space = base64Space) {
+    const bytes = basedToBytes(based, base, space);
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+export function bigIntToUtf8(bigInt) {
+    const bytes = bigIntToBytes(bigInt);
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+export function bytesToUtf8(bytes) {
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+//# sourceMappingURL=to_utf-8.js.map

package/dist/to_utf-8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_utf-8.js","sourceRoot":"","sources":["../src/to_utf-8.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAG3D,MAAM,UAAU,WAAW,CAC1B,KAAa,EACb,IAAY,EACZ,QAAgB,WAAW;IAE3B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAqB;IAChD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@natoboram/based.ts",
-  "version": "0.0.3",
+  "version": "1.0.0",
   "description": "A TypeScript library for working with arbitrary bases",
   "keywords": [
     "base2",
@@ -39,17 +39,20 @@
     "basedts": "dist/main.js"
   },
   "repository": "github:NatoBoram/based.ts",
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
   "devDependencies": {
     "@eslint/js": "^9.9.0",
+    "@types/node": "^22.14.1",
     "eslint": "^9.9.0",
-    "eslint-config-prettier": "^9.1.0",
-    "globals": "^15.9.0",
+    "eslint-config-prettier": "^10.1.2",
+    "globals": "^16.0.0",
     "prettier": "^3.3.3",
-    "tsx": "^4.17.0",
-    "typedoc": "^0.26.5",
-    "typescript": "~5.6.2",
+    "typedoc": "^0.28.1",
+    "typescript": "~5.8.2",
     "typescript-eslint": "^8.0.1",
-    "vitest": "^2.0.5"
+    "vitest": "^3.1.1"
   },
   "type": "module",
   "exports": {
@@ -62,12 +65,14 @@
   "module": "dist/index.js",
   "scripts": {
     "build": "tsc",
-    "dev": "tsx ./src/main.ts",
+    "clean": "rm -rf dist docs node_modules tsconfig.tsbuildinfo",
+    "dev": "node ./src/main.ts",
     "docs": "typedoc",
     "format": "prettier --write .",
     "lint": "eslint . && prettier --check .",
     "lint:fix": "eslint --fix .; prettier --list-different --write .",
     "start": "node dist/main.js",
-    "test": "vitest"
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }