LIVESCRIPT(1)

💖 LIVESCRIPT(1) 💖

okay bestie, listen — this is the manual page for LiveScript, version 1.6.1, from the User Commands corner of the manual. it's giving "cozy little language that compiles to JavaScript" and honestly? iconic. let's get into it ✨

---

🌸 SYNOPSIS 🌸

lsc [option]... [file]...

---

🎀 DESCRIPTION 🎀

so basically, if you run lsc with no options at all, it just starts up the REPL for you. no cap. just vibes and a prompt 🦋

✨ Misc: ✨

• -v, --version — shows you the version, that's it, that's the whole job 💅
• -h, --help — prints this very help message so you're never lost 🫶
• -c, --compile — compiles your stuff to JavaScript and saves it as .js files
• -e, --eval code::String — hands your input over as a string straight from the command line, no file needed
• -d, --prelude — automatically imports prelude.ls in the REPL, so it's just there for you
• -r, --require paths::[String] — requires libraries before executing anything
• -s, --stdin — reads from stdin, lowkey the classic
• -j, --json — prints/compiles as JSON
• -n, --nodejs — everything after this gets passed through to the node binary, iykyk
• -w, --watch — watches your scripts for changes and repeats, over and over, main character energy 🔥
• -k, --const — compiles all variables as constants, commitment issues: none

💜 Output control: 💜

• -o, --output path::String — compiles into the directory you specify
• -p, --print — prints the result to stdout
• -b, --bare — compiles without the top-level function wrapper, naked code fr
• --no-header — doesn't add the "Generated by" header
• -l, --lex — prints the tokens the lexer produces 👀
• -t, --tokens — prints the tokens the rewriter produces
• -a, --ast — prints the syntax tree the parser produces, look at the whole skeleton bestie
• --debug — prints debug output while compiling
• -m, --map String — generates source maps, and it's gotta be one of exactly these: 'none', 'linked', 'linked-src', 'embedded', or 'debug' — no improvising ✋
• --no-warn — suppresses compiler warnings, shhh 🤫

heads up: the value you pass to -m/--map has to be one of those five exact strings, bestie. 'none', 'linked', 'linked-src', 'embedded', 'debug'. that's the whole menu.

also, for the record:

Version 1.6.1 <http://livescript.net/>

---

and that's the page 🎀 thanks for coming to my TED talk. this was LiveScript version 1.6.1, dated June 2022, and it lives at LIVESCRIPT(1). go forth and lsc, bestie 💖✨🦋