C: Allow to reuse arena between multiple parse/lex calls

[marcoroth]

Depends on #726 to be merged first

This pull request adds the ability to reuse an arena allocator across multiple parse and lex calls, reducing memory allocation overhead for batch processing scenarios.

Ruby API

arena = Herb::Arena.new
arena = Herb::Arena.new(size: 1024 * 1024)

result = Herb.parse(source, arena: arena)
result = Herb.lex(source, arena: arena)

arena.position
arena.capacity
arena.reset
arena.stats

JavaScript API (Node.js, Browser, Node-wasm)

const arena = Herb.createArena()
const arena = Herb.createArena({ size: 1024 * 1024 })

const result = Herb.parse(source, { arena })
const result = Herb.lex(source, { arena })

arena.position
arena.capacity
arena.reset()
arena.free()

Example: Batch Processing

const arena = Herb.createArena()

for (const file of files) {
  const result = Herb.parse(file.content, { arena })
  arena.reset()
}

arena.free()

Resolves #1202

[pkg-pr-new]

npx https://pkg.pr.new/@herb-tools/formatter@1203

npx https://pkg.pr.new/@herb-tools/language-server@1203

npx https://pkg.pr.new/@herb-tools/linter@1203

commit: a932d7d

[github-actions]

🌿 Interactive Playground and Documentation Preview

A preview deployment has been built for this pull request. Try out the changes live in the interactive playground:

• Playground Preview
• Documentation Preview
• Website Preview

---

_{🌱 Grown from commit a932d7d}