@rfanth/tjson 0.4.2 → 0.5.0

package/README.md

@@ -23,10 +23,10 @@ TJSON represents the same data model as JSON but renders it in a way that feels
 
 **TJSON output**
 ```
-  name: Alice  age:30  active:true
+  name: Alice    age:30    active:true
   bio: ``
-  | She is a developer.
-  | She loves Rust.
+| She is a developer.
+| She loves Rust.
    ``
   scores:  90, 85, 92
   tags:   rust,  wasm,  json,  serialization
@@ -81,7 +81,7 @@ All four functions throw an `Error` on invalid input.
 
 Options use **camelCase** in JavaScript. The underlying library's Rust API uses snake_case and idiomatic Rust, but exposes the same options.
 
-Key options at a glance:
+**Key options:**
 
 | Option | Default | Description |
 |---|---|---|
@@ -89,20 +89,24 @@ Key options at a glance:
 | `wrapWidth` | `80` | Column wrap limit; `0` for unlimited |
 | `tables` | `true` | Render arrays-of-objects as pipe tables |
 | `multilineStrings` | `true` | Use `\`\`` blocks for strings containing newlines |
-| `bareStrings` | `"prefer"` | Use bare (unquoted) string values when spec permits |
-| `bareKeys` | `"prefer"` | Use bare (unquoted) object keys when spec permits |
 | `inlineObjects` | `true` | Pack multiple key-value pairs onto one line |
 | `inlineArrays` | `true` | Pack multiple array items onto one line |
 | `stringArrayStyle` | `"preferComma"` | How to pack all-string arrays |
-| `indentGlyphStyle` | `"auto"` | When to emit `/<` `/>` glyphs for deeply nested content |
-| `forceMarkers` | `false` | Always emit `=` / `:` markers, even when inferrable |
-| `multilineStyle` | `"bold"` | Multiline block style (`"bold"`, `"floating"`, etc.) |
-| `multilineMinLines` | `1` | Min newlines in a string before using a block |
-| `multilineMaxLines` | `10` | Max lines in a block before falling back |
-| `tableFold` | `false` | Fold long table rows across continuation lines |
-| `tableUnindentStyle` | `"auto"` | How to reposition wide tables using indent glyphs |
+
+**Advanced options:**
+
+| Option | Default | Description |
+|---|---|---|
+| `bareStrings` | `"prefer"` | Use bare (unquoted) string values when spec permits |
+| `bareKeys` | `"prefer"` | Use bare (unquoted) object keys when spec permits |
+| `forceMarkers` | `false` | Force explicit `[` / `{` indent markers on single-step indents |
+| `multilineStyle` | `"bold"` | Multiline block style (`"bold"`, `"floating"`, `"light"`, etc.) |
+| `multilineMinLines` | `1` | Min newlines in a string before using a multiline block |
+| `indentGlyphStyle` | `"auto"` | When to wrap deeply nested content in `/<` `/>` glyphs |
+| `indentGlyphMarkerStyle` | `"compact"` | Where to place the opening `/<` glyph |
+| `tableUnindentStyle` | `"auto"` | How to reposition wide tables toward the left margin |
 | `tableMinRows` | `3` | Min rows required to render a table |
-| `tableMinCols` | `3` | Min columns required to render a table |
+| `tableMinColumns` | `3` | Min columns required to render a table |
 | `tableMinSimilarity` | `0.8` | Min fraction of rows sharing a column |
 | `tableColumnMaxWidth` | `40` | Bail on table if any column exceeds this width |
 | `fold` | — | Set all four fold styles at once; more specific options override |
@@ -110,9 +114,16 @@ Key options at a glance:
 | `stringBareFoldStyle` | `"auto"` | How to fold long bare strings |
 | `stringQuotedFoldStyle` | `"auto"` | How to fold long quoted strings |
 | `stringMultilineFoldStyle` | `"none"` | How to fold multiline block continuation lines |
-| `indentGlyphMarkerStyle` | `"compact"` | Where to place the opening `/<` glyph |
 
-Full option reference with documentation is in the TypeScript types bundled with the package.
+**Experimental options** (may change or be removed in a future version):
+
+| Option | Default | Description |
+|---|---|---|
+| `kvPackMultiple` | `2` | Spacing multiplier between packed key-value pairs (1–4; spaces = value × 2) |
+| `multilineMaxLines` | `10` | Max lines in a `"floating"` block before falling back to `"bold"` |
+| `tableFold` | `false` | Fold long table rows across continuation lines |
+
+Full option reference with inline documentation is in the TypeScript types bundled with the package.
 
 ## Resources
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@rfanth/tjson",
   "type": "module",
   "description": "Text JSON (TJSON) - a readability optimized, round trip compatible alternative to JSON",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",

package/tjson.d.ts

@@ -30,18 +30,18 @@ export interface StringifyOptions {
     multilineStyle?: MultilineStyle;
     /** Minimum number of lines before a multiline block is used. Default: `1`. */
     multilineMinLines?: number;
-    /** Maximum number of lines in a multiline block before falling back. Default: `10`. */
+    /** @experimental Maximum number of lines in a minimal (`) multiline block before falling back to a bold style multiline block (``), applies with multilineStyle: "floating" only.  The idea is that we want to reserve a minimal style multiline for short multilines only for "floating".  "light" has a similar look with no max line fallback.  Default: `10`. */
     multilineMaxLines?: number;
     /** Enable table rendering for uniform arrays-of-objects. Default: `true`. */
     tables?: boolean;
-    /** Allow folding long table rows across continuation lines. Default: `false`. */
+    /** @experimental Allow folding long table rows across continuation lines.  (Not currently implemented.  It is probably best to avoid this option for now as it may change.)  Default: `false`. */
     tableFold?: boolean;
-    /** How to horizontally reposition tables using indent-offset glyphs. Default: `"auto"`. */
+    /** Whether to push wide tables toward the left margin. Independent of `indentGlyphStyle`. Default: `"auto"`. */
     tableUnindentStyle?: TableUnindentStyle;
     /** Minimum rows required to render a table. Default: `3`. */
     tableMinRows?: number;
     /** Minimum columns required to render a table. Default: `3`. */
-    tableMinCols?: number;
+    tableMinColumns?: number;
     /** Minimum fraction [0–1] of rows sharing a column before it's included. Default: `0.8`. */
     tableMinSimilarity?: number;
     /** If any column's content width (including the leading space on bare string values) exceeds this value, the table is abandoned and falls back to block layout. `0` means no limit. Default: `40`. */
@@ -58,10 +58,12 @@ export interface StringifyOptions {
     stringQuotedFoldStyle?: FoldStyle;
     /** How to fold multiline string continuation lines. Default: `"none"`. */
     stringMultilineFoldStyle?: FoldStyle;
-    /** When to emit `/<` `/>` indent-offset glyphs. Default: `"auto"`. */
+    /** Whether to wrap deeply-nested objects and arrays in `/<` `/>` glyphs to reduce visual depth. Independent of `tableUnindentStyle`. Default: `"auto"`. */
     indentGlyphStyle?: IndentGlyphStyle;
     /** Where to place the opening `/<` glyph. Default: `"compact"`. */
     indentGlyphMarkerStyle?: IndentGlyphMarkerStyle;
+    /** @experimental Spacing multiplier between packed key-value pairs. Valid values: 1–4 (clamped); actual spaces = value × 2. Default: `2` (4 spaces). May be changed or removed in a future version. */
+    kvPackMultiple?: number;
 }
 
 /** Parse a TJSON string and return a JSON string. */

package/tjson.js

@@ -1,7 +1,7 @@
 /* @ts-self-types="./tjson.d.ts" */
-
 import * as wasm from "./tjson_bg.wasm";
 import { __wbg_set_wasm } from "./tjson_bg.js";
+
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {

package/tjson_bg.js

@@ -128,7 +128,7 @@ export function toJson(input) {
         wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
     }
 }
-export function __wbg_Error_2e59b1b37a9a34c3(arg0, arg1) {
+export function __wbg_Error_960c155d3d49e4c2(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return ret;
 }
@@ -139,68 +139,68 @@ export function __wbg_String_8564e559799eccda(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_bigint_get_as_i64_2c5082002e4826e2(arg0, arg1) {
+export function __wbg___wbindgen_bigint_get_as_i64_3d3aba5d616c6a51(arg0, arg1) {
     const v = arg1;
     const ret = typeof(v) === 'bigint' ? v : undefined;
     getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
 }
-export function __wbg___wbindgen_boolean_get_a86c216575a75c30(arg0) {
+export function __wbg___wbindgen_boolean_get_6ea149f0a8dcc5ff(arg0) {
     const v = arg0;
     const ret = typeof(v) === 'boolean' ? v : undefined;
     return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
 }
-export function __wbg___wbindgen_debug_string_dd5d2d07ce9e6c57(arg0, arg1) {
+export function __wbg___wbindgen_debug_string_ab4b34d23d6778bd(arg0, arg1) {
     const ret = debugString(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len1 = WASM_VECTOR_LEN;
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_in_4bd7a57e54337366(arg0, arg1) {
+export function __wbg___wbindgen_in_a5d8b22e52b24dd1(arg0, arg1) {
     const ret = arg0 in arg1;
     return ret;
 }
-export function __wbg___wbindgen_is_bigint_6c98f7e945dacdde(arg0) {
+export function __wbg___wbindgen_is_bigint_ec25c7f91b4d9e93(arg0) {
     const ret = typeof(arg0) === 'bigint';
     return ret;
 }
-export function __wbg___wbindgen_is_function_49868bde5eb1e745(arg0) {
+export function __wbg___wbindgen_is_function_3baa9db1a987f47d(arg0) {
     const ret = typeof(arg0) === 'function';
     return ret;
 }
-export function __wbg___wbindgen_is_null_344c8750a8525473(arg0) {
+export function __wbg___wbindgen_is_null_52ff4ec04186736f(arg0) {
     const ret = arg0 === null;
     return ret;
 }
-export function __wbg___wbindgen_is_object_40c5a80572e8f9d3(arg0) {
+export function __wbg___wbindgen_is_object_63322ec0cd6ea4ef(arg0) {
     const val = arg0;
     const ret = typeof(val) === 'object' && val !== null;
     return ret;
 }
-export function __wbg___wbindgen_is_string_b29b5c5a8065ba1a(arg0) {
+export function __wbg___wbindgen_is_string_6df3bf7ef1164ed3(arg0) {
     const ret = typeof(arg0) === 'string';
     return ret;
 }
-export function __wbg___wbindgen_is_undefined_c0cca72b82b86f4d(arg0) {
+export function __wbg___wbindgen_is_undefined_29a43b4d42920abd(arg0) {
     const ret = arg0 === undefined;
     return ret;
 }
-export function __wbg___wbindgen_jsval_eq_7d430e744a913d26(arg0, arg1) {
+export function __wbg___wbindgen_jsval_eq_d3465d8a07697228(arg0, arg1) {
     const ret = arg0 === arg1;
     return ret;
 }
-export function __wbg___wbindgen_jsval_loose_eq_3a72ae764d46d944(arg0, arg1) {
+export function __wbg___wbindgen_jsval_loose_eq_cac3565e89b4134c(arg0, arg1) {
     const ret = arg0 == arg1;
     return ret;
 }
-export function __wbg___wbindgen_number_get_7579aab02a8a620c(arg0, arg1) {
+export function __wbg___wbindgen_number_get_c7f42aed0525c451(arg0, arg1) {
     const obj = arg1;
     const ret = typeof(obj) === 'number' ? obj : undefined;
     getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
 }
-export function __wbg___wbindgen_string_get_914df97fcfa788f2(arg0, arg1) {
+export function __wbg___wbindgen_string_get_7ed5322991caaec5(arg0, arg1) {
     const obj = arg1;
     const ret = typeof(obj) === 'string' ? obj : undefined;
     var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -208,34 +208,34 @@ export function __wbg___wbindgen_string_get_914df97fcfa788f2(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_throw_81fc77679af83bc6(arg0, arg1) {
+export function __wbg___wbindgen_throw_6b64449b9b9ed33c(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
-export function __wbg_call_7f2987183bb62793() { return handleError(function (arg0, arg1) {
+export function __wbg_call_14b169f759b26747() { return handleError(function (arg0, arg1) {
     const ret = arg0.call(arg1);
     return ret;
 }, arguments); }
-export function __wbg_done_547d467e97529006(arg0) {
+export function __wbg_done_9158f7cc8751ba32(arg0) {
     const ret = arg0.done;
     return ret;
 }
-export function __wbg_entries_616b1a459b85be0b(arg0) {
+export function __wbg_entries_e0b73aa8571ddb56(arg0) {
     const ret = Object.entries(arg0);
     return ret;
 }
-export function __wbg_get_4848e350b40afc16(arg0, arg1) {
-    const ret = arg0[arg1 >>> 0];
-    return ret;
-}
-export function __wbg_get_ed0642c4b9d31ddf() { return handleError(function (arg0, arg1) {
+export function __wbg_get_1affdbdd5573b16a() { return handleError(function (arg0, arg1) {
     const ret = Reflect.get(arg0, arg1);
     return ret;
 }, arguments); }
-export function __wbg_get_unchecked_7d7babe32e9e6a54(arg0, arg1) {
+export function __wbg_get_8360291721e2339f(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+}
+export function __wbg_get_unchecked_17f53dad852b9588(arg0, arg1) {
     const ret = arg0[arg1 >>> 0];
     return ret;
 }
-export function __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a(arg0) {
+export function __wbg_instanceof_ArrayBuffer_7c8433c6ed14ffe3(arg0) {
     let result;
     try {
         result = arg0 instanceof ArrayBuffer;
@@ -245,7 +245,7 @@ export function __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_instanceof_Map_a10a2795ef4bfe97(arg0) {
+export function __wbg_instanceof_Map_1b76fd4635be43eb(arg0) {
     let result;
     try {
         result = arg0 instanceof Map;
@@ -255,7 +255,7 @@ export function __wbg_instanceof_Map_a10a2795ef4bfe97(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_instanceof_Uint8Array_4b8da683deb25d72(arg0) {
+export function __wbg_instanceof_Uint8Array_152ba1f289edcf3f(arg0) {
     let result;
     try {
         result = arg0 instanceof Uint8Array;
@@ -265,68 +265,68 @@ export function __wbg_instanceof_Uint8Array_4b8da683deb25d72(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_isArray_db61795ad004c139(arg0) {
+export function __wbg_isArray_c3109d14ffc06469(arg0) {
     const ret = Array.isArray(arg0);
     return ret;
 }
-export function __wbg_isSafeInteger_ea83862ba994770c(arg0) {
+export function __wbg_isSafeInteger_4fc213d1989d6d2a(arg0) {
     const ret = Number.isSafeInteger(arg0);
     return ret;
 }
-export function __wbg_iterator_de403ef31815a3e6() {
+export function __wbg_iterator_013bc09ec998c2a7() {
     const ret = Symbol.iterator;
     return ret;
 }
-export function __wbg_length_0c32cb8543c8e4c8(arg0) {
+export function __wbg_length_3d4ecd04bd8d22f1(arg0) {
     const ret = arg0.length;
     return ret;
 }
-export function __wbg_length_6e821edde497a532(arg0) {
+export function __wbg_length_9f1775224cf1d815(arg0) {
     const ret = arg0.length;
     return ret;
 }
-export function __wbg_new_4f9fafbb3909af72() {
-    const ret = new Object();
+export function __wbg_new_0c7403db6e782f19(arg0) {
+    const ret = new Uint8Array(arg0);
     return ret;
 }
-export function __wbg_new_99cabae501c0a8a0() {
+export function __wbg_new_34d45cc8e36aaead() {
     const ret = new Map();
     return ret;
 }
-export function __wbg_new_a560378ea1240b14(arg0) {
-    const ret = new Uint8Array(arg0);
-    return ret;
-}
-export function __wbg_new_e3b04b4d53d1b593(arg0, arg1) {
+export function __wbg_new_5e360d2ff7b9e1c3(arg0, arg1) {
     const ret = new Error(getStringFromWasm0(arg0, arg1));
     return ret;
 }
-export function __wbg_new_f3c9df4f38f3f798() {
+export function __wbg_new_682678e2f47e32bc() {
     const ret = new Array();
     return ret;
 }
-export function __wbg_next_01132ed6134b8ef5(arg0) {
-    const ret = arg0.next;
+export function __wbg_new_aa8d0fa9762c29bd() {
+    const ret = new Object();
     return ret;
 }
-export function __wbg_next_b3713ec761a9dbfd() { return handleError(function (arg0) {
+export function __wbg_next_0340c4ae324393c3() { return handleError(function (arg0) {
     const ret = arg0.next();
     return ret;
 }, arguments); }
-export function __wbg_prototypesetcall_3e05eb9545565046(arg0, arg1, arg2) {
+export function __wbg_next_7646edaa39458ef7(arg0) {
+    const ret = arg0.next;
+    return ret;
+}
+export function __wbg_prototypesetcall_a6b02eb00b0f4ce2(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
 }
-export function __wbg_set_08463b1df38a7e29(arg0, arg1, arg2) {
-    const ret = arg0.set(arg1, arg2);
-    return ret;
+export function __wbg_set_3bf1de9fab0cd644(arg0, arg1, arg2) {
+    arg0[arg1 >>> 0] = arg2;
 }
 export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
     arg0[arg1] = arg2;
 }
-export function __wbg_set_6c60b2e8ad0e9383(arg0, arg1, arg2) {
-    arg0[arg1 >>> 0] = arg2;
+export function __wbg_set_fde2cec06c23692b(arg0, arg1, arg2) {
+    const ret = arg0.set(arg1, arg2);
+    return ret;
 }
-export function __wbg_value_7f6052747ccf940f(arg0) {
+export function __wbg_value_ee3a06f4579184fa(arg0) {
     const ret = arg0.value;
     return ret;
 }