feat(rules): validate the option examples for rules

[cr7pt0gr4ph7]

Summary

Extend the rules_check to:

(1) Ensure that configuration fragments are actually valid (and do not contain syntax or schema errors):

    /// ```json,options
    /// {
    ///     "options": { ... }
    /// }
    /// ```

(2) Validate rule examples that use a non-default configuration:

    /// ```json,options
    /// {
    ///     "options": { ... }
    /// }
    /// ```
    ///
    /// Invalid example for this configuration:
    ///
    /// ```js,expect_diagnostic,use_options
    /// import "invalid-import";
    /// ```
    ///
    /// Valid example for this configuration:
    ///
    /// ```json,use_options
    /// import "valid-import";
    /// ```

(3) Allow hiding lines from the output like rustdoc does by prefixing them with # .

The corrresponding PR for biomejs/website is biomejs/biome#4542.

Test Plan

• pnpm codegen:rules
• I manually inspected the documentation output generated for the website to ensure it is as intended.

[netlify]

✅ Deploy Preview for biomejs ready!

Name	Link
🔨 Latest commit	33d07f7
🔍 Latest deploy log	https://app.netlify.com/sites/biomejs/deploys/673b444ceac1790008f6e302
😎 Deploy Preview	https://deploy-preview-1442--biomejs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[cr7pt0gr4ph7]

Note: This PR has merge conflicts because it needs to update Cargo.toml with new references to biome packages via specific Git commit SHA references. I'd recommend the following course of action:

1. Review feat(rules_check): validate the option examples for rules biome#4542 first until it is ready to merge
2. Let me integrate the requested changes into this PR
3. Review & merge feat(rules): validate the option examples for rules #1442 so it supports the newly added doc features
4. Merge feat(rules_check): validate the option examples for rules biome#4542
5. Let the CI job update the commit hashes

[ematipico]

You should run pnpm codegen:rules to check end result, and commit those files

[cr7pt0gr4ph7]

You should run pnpm codegen:rules to check end result, and commit those files

Done 👍 Though the changes actually caused by this commit will only show up after biomejs/biome#4542 has been merged, because no json,options blocks exist before that.

[cr7pt0gr4ph7]

I re-ran pnpm codegen:rules after merging in the current changes from main. Should be ready for merge now!

[cr7pt0gr4ph7]

Just as a heads-up, there are problems in the output that are related to/caused by #1440. They are not caused by the changes in this PR, but this PR manages to trigger some edge cases not hit before.

See for example https://deploy-preview-1442--biomejs.netlify.app/linter/rules/use-sorted-classes/#code-related:

[ematipico]

Yeah that's an issue of MDX and the use of JS templates inside the source code. I still have no idea how to fix it properly, but for now we need to live it with it