REGENERATOR(1)

👑 regenerator — the functional JavaScript transformator, bestie 💖

okay so like. you know how sometimes your JS is giving "too new, too shiny" and some sad little runtime out there is like 🥺 "i only speak ES5"? yeah. regenerator is the functional JavaScript transformator that fixes that. she takes your source directory, she takes your output directory, and she serves 💅

---

✨ SYNOPSIS ✨

regenerator [options] <source directory> <output directory> [<module ID>
[<module ID> ...]]

so yeah, you hand her a source directory and an output directory, and then — if you want — you can also pass one or more module IDs after that. no cap. ✨

---

🎀 OPTIONS 🎀

she has SO many flags and honestly? each one is iconic in its own way. let's go, one by one, no skipping, we're not doing that to her 🫶

• -V, --version — prints the version number. that's it. that's the whole vibe. 🏷️
• -c, --config [file] — a JSON configuration file, bestie. and listen: if you pass no file at all, or you pass -, she reads it from STDIN. the pipes are piping. 🍓
• -w, --watch — continually rebuild 🔥 she just keeps going. she keeps rebuilding. she never stops. main character energy fr fr.
• -x, --extension <js | coffee | ...> — the file extension she should assume when resolving module identifiers. like <cyan>js</cyan>, or <cyan>coffee</cyan>, or honestly whatever else you need, the ... is doing a lot of heavy lifting there and we respect it 💜
• --relativize — rewrites all module identifiers to be relative. every single one. periodt.
• --follow-requires — she scans modules for their required dependencies 👀 following the requires like a little detective 🕵️♀️
• --use-provides-module — respect the @providesModules pragma in files. yes ma'am, we honor the pragma 🙏
• --cache-dir <directory> — an alternate directory to use for the disk cache. if you don't like the default spot, you can move her little cache nest 🪺
• --no-cache-dir — disables the disk cache entirely. no cache. none. gone. bye 👋
• --source-charset <utf8 | win1252 | ...> — the charset of the source. default: utf8 ✨
• --output-charset <utf8 | win1252 | ...> — the charset of the output. default: utf8 ✨ (yes, same default, they're matching, it's cute)
• -r, --include-runtime — prepends the runtime to the output. she puts it right at the front, first thing, before everything else 🌸
• --disable-async — disables transformation of async functions. if you're like "bestie please leave my async alone," this is the flag for you 🙈
• -h, --help — display help for command. when in doubt, ask her 💖

ok real talk: if any of these do something you don't expect, that's on you for not reading, not on her. she told you what she does. it's all right here. 💀

---

and that's the whole page, babe. this was regenerator 0.14.10, dated October 2023 🦋 go forth and transform. you're gonna slay. mwah 💅💖