Today, I'm trying to get function signatures for a...
# devlog-togetheri
Ivan Reese
04/03/2024, 8:55 PM
Today, I'm trying to get function signatures for all the std lib stuff in JS… at runtime. Current attempt is converting various d.ts files from the typescript package (like, say, es5.d.ts) into a JSON file with just the bits I need. If that fails, I might try parsing the official WebIDL files (that are used to generate these d.ts files — at least, the dom ones).
If there's a much more obvious way to get this info, let me know. I basically just want something that, for a given function (eg: Array.prototype.splice), gives me some basic signature info (eg: 1-2 args with rest, first arg is called "index", optional second is called "delete", rest is "items"). If all else fails I'll just do .length on these functions, but I'd prefer to get names too.
Ivan Reese
04/03/2024, 9:41 PM
Okay, we're in business. Add "typescript compiler" to the list of stuff going into Hest at runtime (along with "physics engine", "gradient descent", "back propagation", etc)
❤️ 2
Ivan Reese
04/03/2024, 9:44 PM
Yes, I know the above doesn't show the signature info I'm interested in. I got that working separately, but didn't have a good way to screenshot it. 🤷
j
Jack Rusher
04/04/2024, 7:51 AMSome of the APIs are pretty easy to scrape from various documentary sources, but the completist version of this task is a real horror show 🙈
👍 1
b
Beni Cherniavsky-Paskin
04/04/2024, 9:03 PMDunno how complete, but i see Chrome devtools offers argument tooltips as you type. Where does it get that info?
Beni Cherniavsky-Paskin
04/04/2024, 9:04 PMin any case TypeScript can tell you much more about arguments than just their names 👍
i
Ivan Reese
04/04/2024, 9:16 PM
Yeah, I just need to prove out a rough idea. If it works, it'll be easy enough to add more hinting.
Ivan Reese
04/04/2024, 9:18 PM
(Eg: Very tempted to add an LLM that can look at a function call and offer advice about usage. Or, say, answer questions like "what should the inputs to this function be if the output is X?" At runtime. In the tight main event loop.)
j
Jack Rusher
04/05/2024, 1:40 PMThe most complete resources for JS are:
https://github.com/tc39/ecma262
https://github.com/tc39/ecma262/blob/main/spec.html
… but for ahem reasons, this doesn’t include things like
setTimeout