*! version 1.9.2 22Feb2026

help yaml what's newversion 1.9.2

What's New in yaml

Return to main help file

Version 1.9.2 (22Feb2026) -- Parser parity fixes

List-item quote stripping -- The canonical parser now strips surrounding
quotes from YAML list item values, matching the Mata bulk parser behavior.
Previously, values like "Climate Change" retained their quotes in canonical
mode but not in bulk mode.

Sibling parent_stack fix -- Fixed parent_stack contamination where
adjacent parent keys at the same indent level (e.g., topic_ids: followed by
topic_names:) could produce incorrect field names. Both canonical and Mata
bulk parsers now correctly restore the parent context for sibling keys.

Version 1.9.0 (20Feb2026) -- Indicators preset

Indicators Preset -- One-step shortcut for parsing wbopendata and
unicefdata indicator metadata YAML files. Automatically enables bulk
and collapse with standard field selection.

. yaml read using indicators.yaml, indicators replace

Version 1.8.0 (20Feb2026) -- Collapse filter options

Collapse Filters -- Added colfields() to filter collapsed
output to specific field names (semicolon-separated), and maxlevel()
to limit collapsed columns by nesting depth. Designed for large indicator
metadata catalogs.

Added FEAT-09 test for collapse filter options.

Version 1.7.0 (20Feb2026) -- Mata bulk-load and collapse

Bulk Parser -- Added bulk option for high-performance
Mata-based YAML parsing. Combined with collapse, produces wide-format
output with one row per top-level key. Added strl option for values
exceeding 2045 characters.

Added FEAT-05 and FEAT-06 tests for bulk and collapse features.

Version 1.6.0 (18Feb2026)

Mata st_sstore() for embedded quote safety in canonical parser.
Block scalar support (|, >) in canonical parser.
Continuation lines for multi-line scalars.

Version 1.5.1 (18Feb2026)

Bug Fixes

BUG-1: Fixed last_key assignment for leaf keys in yaml read;
list items after a leaf key now reference the correct parent.

BUG-2: Fixed parent_stack update after storing parent keys in
yaml read; nested hierarchy tracking is now correct.

BUG-3: Fixed return value propagation from frame context in yaml get
and yaml list; r() values now persist after the frame block exits.

Enhancements

Added subcommand abbreviations: desc for describe,
frame for frames, check for validate.

Improved error messages: empty and unknown subcommands now list all
valid subcommands.

Added yaml_examples.sthlp with comprehensive usage examples.

Added regression tests REG-01, REG-02, REG-03 to the QA runner.

Version 1.5.0 (04Feb2026)

Added canonical early-exit targets and streaming tokenization options.
Index frame materialization for repeated queries (Stata 16+).
Fast-read block-scalar capture and unsupported-feature checks.
File readability and empty-file checks for yaml read.
Benchmark script and performance targets.

Version 1.4.0 (04Feb2026)

Added fastread mode for speed-first parsing of large, regular YAML files.
Added fields() to restrict extraction to specific keys,
listkeys() for list-block extraction in fast-read mode, and
cache() to store parsed output in a frame (Stata 16+).

Version 1.3.1 (17Dec2025)

Fixed return value propagation from frame context in yaml get and
yaml list. Fixed hyphen-to-underscore normalization in yaml get
search prefix.

Also see

Help: yaml, yaml examples