feat: add Statements, the top-level statement iterator

Assisted-by: GLM 5.3 Flash
2026-09-22 01:12:04 +02:00
parent d92bb56853
commit a7a942a8e1
6 changed files with 233 additions and 0 deletions
@@ -46,6 +46,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
  (10000 levels, which no hand-written document approaches): a document that
  nests arrays or inline tables deeper used to run the stack out and is now
  rejected with a `SyntaxError` naming the limit.
+- `Statements(r)`, an iterator over the top-level statements of the document
+  the reader carries, in written order: key/value statements, a `[table]`
+  header as one statement with its node, an `[[array of tables]]` as one
+  statement per element. A caller that breaks after the statement it wanted
+  reads no further ones. `examples/statements` shows the walk.
 - `ParseAs[T](data)`, the generic one-line decode, and `NewSchema[T]()`,
  which precompiles the struct schema and the interface flags for a hot path
  before the first document arrives.