docs: display class properties and methods in search results

[CodyJasonBennett]

Related issue: #19342
Continues: #21674

Description

This pull request creates a script to auto-generate docs/files.json with class methods and properties enumerated. These are integrated into search results to create marcofugaro's suggested search UI and be consumed by three's Discord bot.

As per marcofugaro's UI, when you search you will find both classes and their methods. Since that may clutter up results unnecessarily, I've opted to allow users to filter using modifiers.

• Queries in PascalCase will search only for sections/classes (when combined with other modifiers, results will only display for a matching section/class)
• . filters to class methods and properties (can be used as a prefix or combined with class names)
• # filters to class methods (can be used as a prefix or combined with class names)

Demo: https://raw.githack.com/CodyJasonBennett/three.js/generate-docs/docs/.

Enhanced.Search.mp4

[CodyJasonBennett]

Maybe we should mirror this for examples (#20207).

[mrdoob]

Sorry, this got lost...

Is there a way to see it live? I'm trying this:
https://raw.githack.com/CodyJasonBennett/three.js/generate-docs/docs/

[CodyJasonBennett]

I'm not sure how I closed this but I can integrate this into the UI.

[CodyJasonBennett]

@mrdoob, that link is now live.

[CodyJasonBennett]

I touched up a bit on the search ergonomics in f285cd4 which should better the search UX with this enhancement (see top comment).

[octopoulos]

I just saw this PR. I think we should try to combine it with the code I did a few days ago, which accelerates the search by a nice factor. What do you think? The timeout code that you added wouldn't be necessary as it would be able to run in real time.

[CodyJasonBennett]

@octopoulos, for sure, and thanks for that.

[octopoulos]

Then I guess I'm going to merge your first commit, the one that creates the files.json, and modify it a bit too to compress the file.
For example, if the URL can be inferred automatically, then I'll skip it, and the docs in other languages than EN don't need to duplicate the data.
As for the docs/index and examples/index, I don't know if everyone will like it, but I'll make them be exactly the same files, that will import a script.js that does both docs and examples, that way, if we switch between docs/examples by clicking on the top links, the switch will be instant since it will stay on the same page and no further preprocessing (loading) will be required.

[CodyJasonBennett]

You might want to have that in a separate PR to facilitate design feedback regarding the proposed UI; don't want that to block the current improvements you made.

[octopoulos]

Yeah, I'm going to make another PR. I guess it will be ready by tomorrow.
Btw, I already did the "shorter" list system, it went from 44kb to 16kb :)

[CodyJasonBennett]

Awesome. I'll close this as we're continuing in #22542.