feat(web): add web generator

[avivkeller]

Fixes #7.

This PR adds the web generator.

Tasks / Issues

P1 – Must Complete Before Merge

• Add more items (anyone can do this as they review¹)

P2 – Must complete before migration

• Add more items (anyone can do this as they review¹)

P3 – Can Be Done in a Follow-up

• Remove mustache dependency
• Adding a tooltip/expand to the DataTag
• Use new Orama UI
• Add more items (anyone can do this as they review¹)

Footnotes

1. Add things as they appear, or leave review comments. ↩ ↩² ↩³

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 64.06480% with 732 lines in your changes missing coverage. Please review.

Project coverage is 70.80%. Comparing base (41ce248) to head (55d2ec7).
Report is 3 commits behind head on main.

✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
src/generators/jsx-ast/utils/buildContent.mjs	26.02%	145 Missing ⚠️
src/generators/web/utils/bundle.mjs	13.33%	91 Missing ⚠️
src/generators/web/utils/generate.mjs	18.81%	82 Missing ⚠️
src/generators/web/utils/css.mjs	21.35%	81 Missing ⚠️
src/generators/jsx-ast/utils/buildSignature.mjs	44.00%	70 Missing ⚠️
src/generators/web/utils/processing.mjs	33.33%	60 Missing ⚠️
...rc/generators/jsx-ast/utils/buildPropertyTable.mjs	76.16%	46 Missing ⚠️
src/generators/web/index.mjs	40.54%	44 Missing ⚠️
src/generators/jsx-ast/index.mjs	26.00%	37 Missing ⚠️
src/generators/jsx-ast/utils/transformer.mjs	12.00%	22 Missing ⚠️
... and 12 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #285      +/-   ##
==========================================
- Coverage   72.14%   70.80%   -1.35%     
==========================================
  Files         117      128      +11     
  Lines        9992    11621    +1629     
  Branches      597      694      +97     
==========================================
+ Hits         7209     8228    +1019     
- Misses       2780     3390     +610     
  Partials        3        3              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[avivkeller]

🎉 The code now dehydrates to the client so it can render without JavaScript!

[AugustinMauroy]

🎉 The code now dehydrates to the client so it run without JavaScript!

Wow 😵‍💫 and what about codetab

[avivkeller]

It rehydrates and runs with JS, but if you don't have JS, you can still view the docs. I used React's SSRing

[avivkeller]

@AugustinMauroy and I got search to finally work 🎉

[avivkeller]

@nodejs/nodejs-website @nodejs/web-infra ChangeHistory and SideBar aren't implemented yet, so this is still a draft, but it's ready for you to take a look, so feel free to review :-)

[ovflowd]

Oh hi @TheAlexLichter just wanted to randomly say thank you for chiming in here 🫶

[TheAlexLichter]

@ovflowd Sure thing! 🙌 Glad I could help ☺️

[avivkeller]

@nodejs/web-infra Is there anything else I missed that I still need to implement. Just waiting on a CODEOWNER review from y'all. We are almost there 🚀!

[ovflowd]

Feature-wise 🚀 -- code wise, 👎

We need to add much more jsdocs, inline comments, extract regexes and things into constants and better simplify/cleanup the code.

Otherwise we will have a hug knowledge gap day one of what each logic means what it does and etc. I also appreciate exmaples on jsdocs. You can use Copilot or some Agentic stuff to help on that if it is massive 😅

[avivkeller]

@ovflowd I've plastered comments all over the code, hopefully it's more intuitive for the future :-). Let me know what else needs to be improved.

A meme summarizing what I've done

[ovflowd]

I'd like you to see if you could simplify or outsource some of the complex .filter/.map functions, so that JavaScript doesn't need to redeclare the function on every call.

There are some visual nitpicks of my liking that if you don't mind would be nice (for me) to be addressed just as it makes my brain go less brrrr.

Finally, just give a last self-review, go through the whole diff slowly and see if there's anything you want to improved.

I'm approving with the hpyothesis that you're going to do that... Or....

[ovflowd]

^{just 270ish comments on the PR, 🍰}

[avivkeller]

There are some visual nitpicks of my liking that if you don't mind would be nice (for me) to be addressed just as it makes my brain go less brrrr.

Sure! Let me know what they are, I'll be happy to investigate (or perhaps you already mentioned them, and I never resolved it?)

[ovflowd]

There are some visual nitpicks of my liking that if you don't mind would be nice (for me) to be addressed just as it makes my brain go less brrrr.

Sure! Let me know what they are, I'll be happy to investigate (or perhaps you already mentioned them, and I never resolved it?)

Pretty much any assignment followed by if statement 😂

[avivkeller]

ahh, I thought you meant the UI

[avivkeller]

Okay, we are so close, everyone!

@ovflowd The following reviews remain unresolved:

• feat(web): add web generator #285 (comment)
• feat(web): add web generator #285 (comment)
• feat(web): add web generator #285 (comment)

I think I've resolved any assignment + if issues.

[avivkeller]

Once those last few reviews are resolved, I'll merge this 🚀

[ovflowd]

@avivkeller feel free to merge!

[ovflowd]

@avivkeller before you merge, ping me on Slack so I can adjust the main branch on Vercel.