Interface ConvertOptions

Bitmark → JSON only: include unknown properties in the bit JSON (default: false). An unknown property ([@key:value] the bit's config cannot resolve, at the bit body/footer — never inside cards or consumed by a chain) is appended after all real keys as an array of strings ([@u] with no value → true); a key colliding with a configured key is _-prefixed. Unknown properties are never converted back to bitmark, and each occurrence still warns.

Indent size for pretty-printing (default: 2).

Input format (default: "auto").

Replace the converted output with a human-readable MAPPING REPORT of what each input construct mapped to — including inputs that are NOT mapped (default: false). Composite conversions (e.g. xml → json) report every leg, one section after the other.

JSON output mode (default: "optimized").

Output format (default: "auto" — the opposite of the input).

Output text as plain text — debug mode (default: false).

"semantic-tokens" and "diagnostics" output only: how columns and lengths are counted — "utf-16" code units (default; the LSP default, what browser editors index by) or "utf-8" bytes. Echoed in the output; ignored by every other output format.

Prettify the JSON being emitted (default: false). For JSON output this is the whole document; for bitmark output it is the embedded JSON bodies of json-format bits (cosmetic — they re-parse to the same value).

Spaces around tag values in bitmark output, 0..=10 (default: 1).

"semantic-tokens" output only: "lsp" (default) writes the relative data array, "absolute" one { line, start, length, type, modifiers } object per token. Ignored by every other output format.

Include validation warnings in parser.warnings output (default: false).