jots 0.2.0

Jot Syntax 1.0 RC6 parser (https://jotsyntax.org)
Documentation
# jots-rs

A Rust implementation of [Jot Syntax](https://jotsyntax.org).

The normative specification lives at <https://jotsyntax.org>. Anything
in this crate is implementation; the spec is the source of truth.

## Usage

```
jots [FILE]
```

Reads from `FILE` or stdin and emits parsed Jot metadata as JSON.

## Iota Syntaxis (Unicode variant)

The [Iota Syntaxis](https://iotasyntaxis.org) variant widens the
identifier and filename character classes to Unicode
`XID_Start`/`XID_Continue`. It is runtime config: `--unicode` on
the CLI, or `Config::unicode` on the API. The sibling
[`iotas`](iotas/) crate in this repo wraps `jots` with the
variant preset and ships the `iotas` binary.

## Category root

`--category-root WORD` (config key `category_root`, env
`JOTS_CATEGORY_ROOT`; SPEC §9.1) requires every category path to
start with `WORD`. A path that does not — `::title` when the root
is `cat` — is ordinary text, both free-standing and as an
annotation suffix, so host-language `::` tokens (Rust `::std::fmt`,
C++ `::std::vector`, Quarb `::title`) stop parsing as categories.
Rooted paths are emitted unchanged, root segment included.

## Status

Tracks Jot Syntax 1.0 RC6 (2026-10-08). Scope is the **parser**
only; the renderer (a separate peer spec) lives in the sibling
[`jotr-rs`](https://gitlab.com/jot-syntax/jotr-rs).

Passes the full conformance suite at
[gitlab.com/jot-syntax/jots-tests](https://gitlab.com/jot-syntax/jots-tests).