(*---------------------------------------------------------------------------
  Copyright (c) 2025 Anil Madhavapeddy <anil@recoil.org>. All rights reserved.
  SPDX-License-Identifier: ISC
 ---------------------------------------------------------------------------*)

(** Browser-compatible test runner for html5rw regression tests.

    This module provides functions to run html5lib conformance tests
    in the browser. Test data is provided as strings and results are
    returned as JavaScript-accessible objects.

    {2 JavaScript API}

    The following functions are exposed to JavaScript via the global
    [html5rwTests] object:

    - [html5rwTests.runTreeConstructionTest(filename, content)] - Run tree
      construction tests from a .dat file content
    - [html5rwTests.runEncodingTest(filename, content)] - Run encoding
      detection tests from a .dat file content
    - [html5rwTests.runAllTests(files)] - Run all tests from an array of
      file objects with {type, filename, content}
    - [html5rwTests.quickParseTest(html)] - Quick parse test for a single
      HTML string
    - [html5rwTests.version] - Version string *)