@emagjby/strata-js 0.3.3 → 0.4.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emagjby
+
+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/README.md

@@ -1,16 +1,52 @@
 # @emagjby/strata-js
 
-Deterministic Strata implementation for JavaScript.
+**Deterministic Strata implementation for JavaScript.**
 
-Strata is a deterministic binary data format with canonical encoding: identical logical values must produce identical bytes (and therefore identical hashes) across all implementations.
+This package is the **JavaScript parity implementation** of **Strata**.
 
-This package is a **parity implementation** with the Rust reference implementation. If Rust and JavaScript ever disagree, **that is a bug**.
+> Same data → same bytes → same hash.  
+> No ambiguity. No normalization. No silent coercions.
 
-- Canonical encoding: one value → one byte representation
-- Hashing: stable hash over canonical bytes (BLAKE3-256)
-- Strata Text (`.st`): human authoring format that compiles to canonical Strata Core Binary (`.scb`)
+If Rust and JavaScript ever disagree, **that is a bug**.
 
-Docs: https://strata.emagjby.com/docs
+---
+
+## What is Strata?
+
+Strata is a **strict, minimal data model** with a **fully deterministic binary encoding**.
+
+It is designed for systems where:
+
+- data integrity is non-negotiable
+- hashes must be stable forever
+- cross-language verification is required
+- ambiguity is unacceptable
+
+Strata draws a hard line between **representation** and **truth**:
+
+- `Value` is an in-memory representation
+- canonical `.scb` bytes define truth
+- hashes are computed only from canonical bytes
+
+---
+
+## What this package provides
+
+This package provides:
+
+- Canonical encoder for Strata Core Binary (`.scb`)
+- Safe decoder with explicit error semantics
+- Parser for Strata Text (`.st`)
+- Deterministic BLAKE3 hashing
+- Deterministic formatting (`fmt`)
+- CLI tooling (mirrors Rust CLI)
+- Golden vector enforcement
+- Behavioral parity with the Rust reference implementation
+
+This package does **not** define canonical truth.  
+The Rust implementation does.
+
+---
 
 ## Install
 
@@ -26,9 +62,11 @@ CLI:
 npm install -g @emagjby/strata-js
 ```
 
+---
+
 ## Quickstart (Library)
 
-### Parse Strata Text (`.st`) → encode (`.scb`) → hash
+### Parse `.st` → encode `.scb` → hash
 
 ```js
 import { parse, encodeValue, hashValueHex } from "@emagjby/strata-js";
@@ -40,39 +78,126 @@ const source = `{
 }`;
 
 const value = parse(source);
-const scb = encodeValue(value); // Uint8Array canonical bytes
+const scb = encodeValue(value); // Uint8Array (canonical bytes)
 
-// Hashing is defined over canonical bytes.
+// Hashing is defined over canonical bytes
 console.log(hashValueHex(value));
 ```
 
-### Decode `.scb` bytes back into a Strata value
+---
+
+### Decode `.scb` bytes back into a Value
 
 ```js
 import { decodeValue, encodeValue } from "@emagjby/strata-js";
 
-// Given canonical bytes (or bytes captured from storage/wire)
 const originalScb = new Uint8Array([0x00]); // example only
 
 const value = decodeValue(originalScb);
 const roundtrippedScb = encodeValue(value);
 
-// Strata guarantees: decode(encode(value)) == value
-// The reverse is intentionally NOT guaranteed.
+// Guaranteed: encode(decode(bytes)) === bytes
+// NOT guaranteed: decode(encode(value)) === value
 console.log(roundtrippedScb);
 ```
 
-### Hash a value (canonical re-encode)
+---
 
-If you already have a JS `Value` and want a canonical hash:
+### Hash an existing Value
 
 ```js
-import { hashValueHex, parse } from "@emagjby/strata-js";
+import { parse, hashValueHex } from "@emagjby/strata-js";
 
 const value = parse("[1, 2, 3]");
 console.log(hashValueHex(value));
 ```
 
+---
+
+## Constructing Values (JavaScript)
+
+The recommended construction API is the **`Value` factory**.
+
+The legacy alias `V` remains supported for backwards compatibility.
+
+```js
+import { Value } from "@emagjby/strata-js";
+
+const value = Value.mapOf(
+  ["id", Value.int(42n)],
+  ["name", Value.string("Gencho")],
+  ["active", Value.bool(true)],
+  ["skills", Value.listOf(Value.string("rust"), Value.string("systems"))],
+  [
+    "meta",
+    Value.mapOf(
+      ["a", Value.int(1n)],
+      ["a", Value.int(2n)], // last-write-wins
+    ),
+  ],
+);
+```
+
+Available helpers:
+
+- `Value.null()`
+- `Value.bool(boolean)`
+- `Value.int(bigint)` **(BigInt only)**
+- `Value.string(string)`
+- `Value.bytes(Uint8Array)`
+- `Value.list(Value[])`
+- `Value.map(Iterable<[string, Value]>)`
+
+DX helpers (additive):
+
+- `Value.listOf(...Value)`
+- `Value.mapObj({ [key]: Value })`
+- `Value.mapOf(...[string, Value])`
+- `Value.bytesFrom(Uint8Array | ArrayBuffer | number[] | Iterable<number>)`
+- `Value.bytesHex(hexString)` (strict hex)
+
+Duplicate map keys resolve via **last-write-wins**.
+
+---
+
+## JavaScript Value model (important)
+
+Strata values are **not JSON** and are intentionally strict.
+
+Rules:
+
+- Integers are `bigint` (JS `number` is rejected)
+- Bytes are `Uint8Array`
+- Maps are `ReadonlyMap<string, Value>`
+- No floats
+- No implicit conversions
+
+Type shape (abridged):
+
+- `{ kind: "null" }`
+- `{ kind: "bool", value: boolean }`
+- `{ kind: "int", value: bigint }`
+- `{ kind: "string", value: string }`
+- `{ kind: "bytes", value: Uint8Array }`
+- `{ kind: "list", value: readonly Value[] }`
+- `{ kind: "map", value: ReadonlyMap<string, Value> }`
+
+If you need JSON interoperability, you must define an **explicit mapping**.
+
+---
+
+## Canonical encoding & determinism
+
+- Encoding is fully deterministic
+- Map keys are sorted by UTF-8 byte order during encoding
+- Duplicate keys overwrite earlier entries (last-write-wins)
+- Hashing is defined over canonical `.scb` bytes
+
+If your system needs “mostly the same bytes”, Strata is not the tool.  
+If it needs **exactly the same bytes**, it is.
+
+---
+
 ## CLI
 
 The `strata-js` CLI mirrors the Rust CLI.
@@ -80,9 +205,9 @@ The `strata-js` CLI mirrors the Rust CLI.
 Commands:
 
 - `compile` – compile `.st` → canonical `.scb`
-- `decode` – decode `.scb` into a stable inspection format
-- `hash` – compute deterministic hash (BLAKE3-256)
-- `fmt` – parse `.st` and print a structured inspection format
+- `decode` – decode `.scb` for inspection
+- `hash` – compute deterministic hash
+- `fmt` – parse and pretty-print `.st` (or `.scb`)
 
 ### Compile
 
@@ -99,8 +224,8 @@ strata-js hash input.scb
 
 Behavior:
 
-- If input is `.st`, it is parsed and canonically encoded first
-- If input is `.scb`, bytes are hashed directly
+- `.st` is parsed and canonically encoded first
+- `.scb` bytes are hashed directly
 - Output is lowercase hex
 
 ### Decode
@@ -109,10 +234,18 @@ Behavior:
 strata-js decode input.scb
 ```
 
-### Fmt
+### Format
 
 ```bash
 strata-js fmt input.st
+strata-js fmt input.scb
+```
+
+Format options:
+
+```bash
+strata-js fmt --format pretty input.st
+strata-js fmt --format ast input.st
 ```
 
 ### Exit codes
@@ -122,59 +255,59 @@ strata-js fmt input.st
 - `2` I/O failure
 - `100` internal error
 
-## JavaScript value model (important)
-
-Strata values in JS are **not JSON** and are intentionally strict.
-
-- Integers are `bigint` (JS `number` MUST NOT be used)
-- Bytes are `Uint8Array`
-- Maps are `ReadonlyMap<string, Value>`
-
-If you need to bridge into JSON:
-
-- `bigint` cannot be directly serialized by `JSON.stringify`
-- You must choose an explicit representation (commonly decimal strings)
-
-Type shape (abridged):
-
-- `{ kind: "null" }`
-- `{ kind: "bool", value: boolean }`
-- `{ kind: "int", value: bigint }`
-- `{ kind: "string", value: string }`
-- `{ kind: "bytes", value: Uint8Array }`
-- `{ kind: "list", value: readonly Value[] }`
-- `{ kind: "map", value: ReadonlyMap<string, Value> }`
-
-## Determinism notes
-
-- Hashing is defined over **canonical encoded bytes**, not decoded structures.
-- Decoding exists to inspect reality; encoding defines canonical truth.
-- Map keys are canonically ordered by UTF-8 byte order during encoding.
-
-If your system needs “mostly the same bytes”, Strata is not the tool. If it needs _exactly the same bytes_, it is.
+---
 
 ## Golden vectors
 
-Strata correctness is enforced via golden vectors (authored in `.st`) and cross-implementation tests.
+Correctness is enforced using **golden vectors** shared with the Rust implementation.
+
+Golden vectors are law:
 
-Golden vectors are not examples; they are law:
+- If this package disagrees with vectors, **this package is wrong**
+- Vectors are not adjusted to match buggy behavior
 
-- If this package disagrees with a golden vector, **the implementation is wrong**.
-- Vectors are not adjusted to match buggy behavior.
+---
 
 ## What Strata does NOT do
 
 Strata intentionally does not provide:
 
 - Schemas or validation rules
-- Optional fields or default values
+- Optional fields or defaults
 - Backward-compatible schema evolution
 - Floating point numbers
-- Streaming/framing rules (transport concerns are external)
+- Streaming or framing rules
 - Compression, encryption, or authentication
 
+---
+
+## Documentation
+
+Canonical integration documentation lives in the **Integration Reference**:
+
+https://strata.emagjby.com/docs
+
+This is the **single source of truth** for integrators.
+
+---
+
 ## Links
 
 - Documentation: https://strata.emagjby.com/docs
-- Repo: https://github.com/Emagjby/Strata
-- Strata JS package source: https://github.com/Emagjby/Strata/tree/main/strata-js
+- Monorepo: https://github.com/Emagjby/Strata
+- JS source: https://github.com/Emagjby/Strata/tree/main/strata-js
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Final note
+
+This package is intentionally strict.
+
+If convenience matters more than correctness, use something else.  
+If correctness matters, this is the JavaScript implementation.

package/dist/cli.d.ts

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 import fs from "node:fs";
 import process from "node:process";
 import { parse } from "./parser.js";
@@ -8,6 +8,7 @@ import { hashBytes } from "./hash.js";
 import { DecodeError } from "./decode_error.js";
 import { ParseError } from "./parse_error.js";
 import { inspectValue } from "./inspect.js";
+import { fmt, FormatOptions } from "./fmt.js";
 function exitOk() {
     process.exit(0);
 }
@@ -57,10 +58,12 @@ function cmdHash(input) {
     const hashed = hashBytes(encoded);
     console.log(hex(hashed));
 }
-function cmdFmt(input) {
-    const source = fs.readFileSync(input, "utf8");
-    const parsedValue = parse(source);
-    console.log(JSON.stringify(inspectValue(parsedValue), null, 2));
+function cmdFmt(input, options = FormatOptions.PRETTY) {
+    const value = input.endsWith(".scb")
+        ? decodeValue(fs.readFileSync(input))
+        : parse(fs.readFileSync(input, "utf8"));
+    const formatted = fmt(options, value);
+    console.log(formatted);
 }
 function main() {
     const [, , cmd, ...args] = process.argv;
@@ -90,21 +93,34 @@ function main() {
             return exitOk();
         }
         case "fmt": {
-            if (args.length !== 1) {
-                exitInvalid("usage: strata-js fmt <input.st>");
+            if (args.length < 1 || args.length > 3)
+                return exitInvalid("usage: strata-js fmt [format] <input.st>");
+            if (args.length === 2) {
+                return exitInvalid("usage: --format [type] must be provided if format is provided");
+            }
+            if (args.length === 1) {
+                cmdFmt(args[0]);
+                return exitOk();
+            }
+            if (args[0] !== "--format") {
+                return exitInvalid("usage: first argument must be --format if format is provided");
+            }
+            if (args[1] !== "pretty" && args[1] !== "ast") {
+                return exitInvalid("usage: format type must be one of: pretty, ast");
             }
-            cmdFmt(args[0]);
+            const format = args[1] === "pretty" ? FormatOptions.PRETTY : FormatOptions.AST;
+            cmdFmt(args[2], format);
             return exitOk();
         }
         case "--help": {
             console.log(`
-                Strata CLI (JavaScript)
+Strata CLI (JavaScript)
 
-                Commands:
-                  compile <input.st> <output.scb>
-                  decode <input.scb>
-                  hash <input.st|input.scb>
-                  fmt <input.st>
+Commands:
+  compile <input.st> <output.scb>
+  decode <input.scb>
+  hash <input.st|input.scb>
+  fmt [format] <input.st>
             `);
             process.exit(0);
         }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,SAAS,MAAM;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC7B,IAAI,GAAG,EAAE,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IACxB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAC9B,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAChC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,GAAG,CAAC,KAAiB;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,MAAc;IAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC5B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC1B,IAAI,OAAmB,CAAC;IAExB,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACJ,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IACzB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,IAAI;IACT,MAAM,CAAC,EAAE,AAAD,EAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAExC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,GAAG,EAAE,CAAC;QACV,KAAK,SAAS,CAAC,CAAC,CAAC;YACb,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,kDAAkD,CAAC,CAAC;YACpE,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YAC/B,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,qCAAqC,CAAC,CAAC;YACvD,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YACpB,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACV,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,4CAA4C,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YAClB,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,KAAK,CAAC,CAAC,CAAC;YACT,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,iCAAiC,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YACjB,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC;;;;;;;;aAQX,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED;YACI,WAAW,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;AACL,CAAC;AAED,IAAI,CAAC;IACD,IAAI,EAAE,CAAC;AACX,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACX,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAK,GAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1E,MAAM,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,SAAS,MAAM;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC7B,IAAI,GAAG,EAAE,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IACxB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAC9B,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAChC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,GAAG,CAAC,KAAiB;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,MAAc;IAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC5B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC1B,IAAI,OAAmB,CAAC;IAExB,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACJ,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,MAAM,CACX,KAAa,EACb,UAAyB,aAAa,CAAC,MAAM;IAE7C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,IAAI;IACT,MAAM,CAAC,EAAE,AAAD,EAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAExC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,GAAG,EAAE,CAAC;QACV,KAAK,SAAS,CAAC,CAAC,CAAC;YACb,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,kDAAkD,CAAC,CAAC;YACpE,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YAC/B,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,qCAAqC,CAAC,CAAC;YACvD,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YACpB,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACV,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,WAAW,CAAC,4CAA4C,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YAClB,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,KAAK,CAAC,CAAC,CAAC;YACT,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAClC,OAAO,WAAW,CAAC,0CAA0C,CAAC,CAAC;YACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,WAAW,CACd,+DAA+D,CAClE,CAAC;YACN,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;gBACjB,OAAO,MAAM,EAAE,CAAC;YACpB,CAAC;YAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;gBACzB,OAAO,WAAW,CACd,8DAA8D,CACjE,CAAC;YACN,CAAC;YAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC5C,OAAO,WAAW,CAAC,gDAAgD,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,MAAM,GACR,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC;YAEpE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC;YACzB,OAAO,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC;;;;;;;;aAQX,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED;YACI,WAAW,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;AACL,CAAC;AAED,IAAI,CAAC;IACD,IAAI,EAAE,CAAC;AACX,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACX,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAK,GAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1E,MAAM,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/dist/fmt.d.ts

@@ -0,0 +1,7 @@
+import { Value } from "./value.js";
+export declare enum FormatOptions {
+    PRETTY = "PRETTY",
+    AST = "AST"
+}
+export declare function fmt(opts: FormatOptions, value: Value): string;
+//# sourceMappingURL=fmt.d.ts.map

package/dist/fmt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fmt.d.ts","sourceRoot":"","sources":["../src/fmt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,oBAAY,aAAa;IACrB,MAAM,WAAW;IACjB,GAAG,QAAQ;CACd;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAU7D"}

package/dist/fmt.js

@@ -0,0 +1,84 @@
+export var FormatOptions;
+(function (FormatOptions) {
+    FormatOptions["PRETTY"] = "PRETTY";
+    FormatOptions["AST"] = "AST";
+})(FormatOptions || (FormatOptions = {}));
+export function fmt(opts, value) {
+    switch (opts) {
+        case FormatOptions.PRETTY: {
+            const f = new PrettyFmt();
+            f.value(value);
+            return f.out;
+        }
+        case FormatOptions.AST:
+            return prettyDebug(value);
+    }
+}
+class PrettyFmt {
+    out = "";
+    depth = 0;
+    indent = 2;
+    pad() {
+        return " ".repeat(this.depth * this.indent);
+    }
+    value(v) {
+        switch (v.kind) {
+            case "null":
+                this.out += "null";
+                break;
+            case "bool":
+                this.out += String(v.value);
+                break;
+            case "int":
+                this.out += String(v.value);
+                break;
+            case "string":
+                this.out += `"${v.value}"`;
+                break;
+            case "bytes":
+                this.bytes(v.value);
+                break;
+            case "list":
+                this.list(v.value);
+                break;
+            case "map":
+                this.map(v.value);
+                break;
+        }
+    }
+    bytes(bytes) {
+        this.out += "[";
+        for (const b of bytes) {
+            this.out += b.toString(16).padStart(2, "0");
+        }
+        this.out += "]";
+    }
+    list(list) {
+        this.out += "[";
+        for (let i = 0; i < list.length; i++) {
+            this.value(list[i]);
+            if (i + 1 !== list.length)
+                this.out += ", ";
+        }
+        this.out += "]";
+    }
+    map(map) {
+        this.out += "{\n";
+        this.depth += 1;
+        const entries = [...map.entries()].sort(([a], [b]) => a.localeCompare(b));
+        for (const [k, v] of entries) {
+            this.out += this.pad();
+            this.out += k;
+            this.out += ": ";
+            this.value(v);
+            this.out += "\n";
+        }
+        this.depth -= 1;
+        this.out += this.pad();
+        this.out += "}";
+    }
+}
+function prettyDebug(value) {
+    return JSON.stringify(value, null, 2);
+}
+//# sourceMappingURL=fmt.js.map

package/dist/fmt.js.map

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

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { encodeValue } from "./encode.js";
 export { decodeValue } from "./decode.js";
 export { hashValueHex, hashBytes as hashValue } from "./hash.js";
 export { parse } from "./parser.js";
+export { fmt } from "./fmt.js";
+export { Value, V } from "./value_factory.js";
 export { V as ValueFactory } from "./value_factory.js";
 export * from "./value.js";
 export * from "./decode_error.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -4,6 +4,8 @@ export { encodeValue } from "./encode.js";
 export { decodeValue } from "./decode.js";
 export { hashValueHex, hashBytes as hashValue } from "./hash.js";
 export { parse } from "./parser.js";
+export { fmt } from "./fmt.js";
+export { Value, V } from "./value_factory.js";
 export { V as ValueFactory } from "./value_factory.js";
 export * from "./value.js";
 export * from "./decode_error.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/value_factory.d.ts

@@ -1,11 +1,30 @@
-import { Value, NullValue, BoolValue, IntValue, StringValue, BytesValue, ListValue, MapValue } from "./value.js";
+import { Value as ValueT, NullValue, BoolValue, IntValue, StringValue, BytesValue, ListValue, MapValue } from "./value.js";
+export declare const Value: {
+    readonly null: () => NullValue;
+    readonly bool: (value: boolean) => BoolValue;
+    readonly int: (value: bigint) => IntValue;
+    readonly string: (value: string) => StringValue;
+    readonly bytes: (value: Uint8Array) => BytesValue;
+    readonly bytesFrom: (value: ArrayBuffer | Uint8Array | readonly number[] | Iterable<number>) => BytesValue;
+    readonly bytesHex: (hex: string) => BytesValue;
+    readonly list: (value: readonly ValueT[]) => ListValue;
+    readonly listOf: (...values: ValueT[]) => ListValue;
+    readonly map: (entries: Iterable<[string, ValueT]>) => MapValue;
+    readonly mapObj: (obj: Record<string, ValueT>) => MapValue;
+    readonly mapOf: (...entries: [string, ValueT][]) => MapValue;
+};
 export declare const V: {
     readonly null: () => NullValue;
     readonly bool: (value: boolean) => BoolValue;
     readonly int: (value: bigint) => IntValue;
     readonly string: (value: string) => StringValue;
     readonly bytes: (value: Uint8Array) => BytesValue;
-    readonly list: (value: readonly Value[]) => ListValue;
-    readonly map: (entries: Iterable<[string, Value]>) => MapValue;
+    readonly bytesFrom: (value: ArrayBuffer | Uint8Array | readonly number[] | Iterable<number>) => BytesValue;
+    readonly bytesHex: (hex: string) => BytesValue;
+    readonly list: (value: readonly ValueT[]) => ListValue;
+    readonly listOf: (...values: ValueT[]) => ListValue;
+    readonly map: (entries: Iterable<[string, ValueT]>) => MapValue;
+    readonly mapObj: (obj: Record<string, ValueT>) => MapValue;
+    readonly mapOf: (...entries: [string, ValueT][]) => MapValue;
 };
 //# sourceMappingURL=value_factory.d.ts.map

package/dist/value_factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value_factory.d.ts","sourceRoot":"","sources":["../src/value_factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EACL,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACX,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,CAAC;yBACF,SAAS;2BAIL,OAAO,KAAG,SAAS;0BAIpB,MAAM,KAAG,QAAQ;6BAOd,MAAM,KAAG,WAAW;4BAIrB,UAAU,KAAG,UAAU;2BAOxB,SAAS,KAAK,EAAE,KAAG,SAAS;4BAI3B,QAAQ,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAG,QAAQ;CAG3C,CAAC"}
+{"version":3,"file":"value_factory.d.ts","sourceRoot":"","sources":["../src/value_factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,IAAI,MAAM,EACf,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACX,MAAM,YAAY,CAAC;AAoCpB,eAAO,MAAM,KAAK;yBACN,SAAS;2BAIL,OAAO,KAAG,SAAS;0BAIpB,MAAM,KAAG,QAAQ;6BAOd,MAAM,KAAG,WAAW;4BAIrB,UAAU,KAAG,UAAU;gCAQzB,WAAW,GAAG,UAAU,GAAG,SAAS,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,KACvE,UAAU;6BAcC,MAAM,KAAG,UAAU;2BAIrB,SAAS,MAAM,EAAE,KAAG,SAAS;iCAIvB,MAAM,EAAE,KAAG,SAAS;4BAIzB,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,QAAQ;2BAItC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,QAAQ;iCAO3B,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAG,QAAQ;CAGzC,CAAC;AAEX,eAAO,MAAM,CAAC;yBAtEF,SAAS;2BAIL,OAAO,KAAG,SAAS;0BAIpB,MAAM,KAAG,QAAQ;6BAOd,MAAM,KAAG,WAAW;4BAIrB,UAAU,KAAG,UAAU;gCAQzB,WAAW,GAAG,UAAU,GAAG,SAAS,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,KACvE,UAAU;6BAcC,MAAM,KAAG,UAAU;2BAIrB,SAAS,MAAM,EAAE,KAAG,SAAS;iCAIvB,MAAM,EAAE,KAAG,SAAS;4BAIzB,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,QAAQ;2BAItC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,QAAQ;iCAO3B,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAG,QAAQ;CAK7B,CAAC"}

package/dist/value_factory.js

@@ -1,4 +1,33 @@
-export const V = {
+function assertByte(n) {
+    if (!Number.isInteger(n) || n < 0 || n > 255) {
+        throw new TypeError("Byte values must be integers in range 0..255");
+    }
+}
+function bytesFromIterable(it) {
+    const out = [];
+    for (const n of it) {
+        assertByte(n);
+        out.push(n);
+    }
+    return Uint8Array.from(out);
+}
+function bytesFromHexStrict(hex) {
+    if (typeof hex !== "string") {
+        throw new TypeError("Hex string must be a string");
+    }
+    if (hex.length % 2 !== 0) {
+        throw new TypeError("Hex string must have even length");
+    }
+    if (!/^[0-9a-fA-F]*$/.test(hex)) {
+        throw new TypeError("Hex string contains invalid characters");
+    }
+    const out = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        out[i / 2] = Number.parseInt(hex.slice(i, i + 2), 16);
+    }
+    return out;
+}
+export const Value = {
     null() {
         return { kind: "null" };
     },
@@ -20,11 +49,41 @@ export const V = {
         }
         return { kind: "bytes", value };
     },
+    bytesFrom(value) {
+        if (value instanceof Uint8Array) {
+            return Value.bytes(value);
+        }
+        if (value instanceof ArrayBuffer) {
+            return Value.bytes(new Uint8Array(value));
+        }
+        if (Array.isArray(value)) {
+            for (const n of value)
+                assertByte(n);
+            return Value.bytes(Uint8Array.from(value));
+        }
+        return Value.bytes(bytesFromIterable(value));
+    },
+    bytesHex(hex) {
+        return Value.bytes(bytesFromHexStrict(hex));
+    },
     list(value) {
         return { kind: "list", value };
     },
+    listOf(...values) {
+        return { kind: "list", value: values };
+    },
     map(entries) {
         return { kind: "map", value: new Map(entries) };
     },
+    mapObj(obj) {
+        return {
+            kind: "map",
+            value: new Map(Object.entries(obj)),
+        };
+    },
+    mapOf(...entries) {
+        return { kind: "map", value: new Map(entries) };
+    },
 };
+export const V = Value;
 //# sourceMappingURL=value_factory.js.map

package/dist/value_factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"value_factory.js","sourceRoot":"","sources":["../src/value_factory.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,CAAC,GAAG;IACb,IAAI;QACA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,KAAc;QACf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,KAAa;QACb,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,KAAa;QAChB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAiB;QACnB,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,KAAuB;QACxB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,OAAkC;QAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,CAAC;CACK,CAAC"}
+{"version":3,"file":"value_factory.js","sourceRoot":"","sources":["../src/value_factory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@emagjby/strata-js",
-  "version": "0.3.3",
+  "version": "0.4.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js"
   },
+  "license": "MIT",
+  "author": "Emagjby",
   "bin": {
     "strata-js": "./dist/cli.js"
   },