release/v0.2.0

[lcweden]

This pull request delivers a significant update to the jsontext project, focusing on improving usability, documentation, and compatibility. The most notable changes include a complete overhaul of the README.md for clarity and modern usage, version bumps for both Deno and npm packages, and enhancements to the encoder API. Additionally, there are several improvements to Deno configuration for linting and experimental features, and a new Node.js engine requirement.

Documentation and Examples:

• Major rewrite of README.md:
  • Provides clearer explanations of concepts, usage, and APIs.
  • Adds more practical and modern JavaScript examples.
  • Includes new sections on concepts, error handling, and advanced pipelines.
  • Updates installation instructions for both npm and Deno.
  • Improves API reference tables and links to external documentation.

API and Code Improvements:

• JSONTextEncoder API change:
  • Replaces the bytes() method with a new takeBytes() method, which drains and clears the internal buffer after each call, allowing for more efficient streaming and incremental encoding. [1] [2]
• Updates import paths in TypeScript source files to remove .ts extensions for better compatibility with both Node.js and Deno. [1] [2]

Package and Configuration Updates:

• Bump version from 0.1.0 to 0.2.0 in both package.json and deno.json to reflect breaking and significant changes. [1] [2]
• Add Node.js engine requirement (>=18) in package.json to clarify runtime compatibility.

Deno Linting and Experimental Features:

• Update Deno lint configuration:
  • Excludes no-sloppy-imports rule and enables the sloppy-imports unstable feature to improve developer experience with imports.
  • Refines excluded directories for better tooling performance.

These changes collectively improve developer onboarding, clarify project capabilities, and ensure smoother integration across JavaScript runtimes.