Lightnews — Scholar-powered news

souporserious.com @souporserious.com · 10h

renoun has taken a long time to build because I run into every single issue it's trying to solve for the documentation site. It feels good to finally talk about now though, I'm really happy with where the API is. The changelog is quite the history of where it has been so far 😄 renoun.dev/changelog

renoun - The Documentation Toolkit for React

The renoun toolkit uses your React framework to keep documentation polished, in sync, and on brand.

renoun.dev

1 3

souporserious.com @souporserious.com · 12h

It's fully composable through React Server components that work with any bundler and ships everything you need in one package: syntax highlighting, support for multiple themes, advanced API references, table of contents, and a full-featured file system utility that works with each component.

souporserious.com @souporserious.com · 2d

Thank you, Josh! 😊

souporserious.com @souporserious.com · 2d

Excited to officially launch renoun.dev 🚀

This has been years in the making to deliver a focused set of components, hooks, and utilities in React for building great documentation exactly to your standards that always stay in sync.

renoun - The Documentation Toolkit for React

The renoun toolkit uses your React framework to keep documentation polished, in sync, and on brand.

renoun.dev

1 3 19

souporserious.com @souporserious.com · Jul 31

Is Promise.all necessary when returning an array of promises as children or will Suspense/SuspenseList essentially optimize this?

I also noticed iterator maps work as well which is so nice! Would be great to document this as well.

1

souporserious.com @souporserious.com · Jul 31

Documenting inversion of control could help here instead of baking it in:
const transition = useTransition()
<Button transition={transition}>...</Button>

Then if it's not defined the Button works as normal.

1

souporserious.com @souporserious.com · Jul 16

Yeah, it's super limited and tedious to manage this way. Hopefully we'll get first-class support for classes and more advanced overloading someday.

1

souporserious.com @souporserious.com · Jul 16

You can kind of accomplish this using assertions on getters and then "this" parameter for methods www.typescriptlang.org/play/#code/M...

TS Playground - An online editor for exploring TypeScript and JavaScript

The Playground lets you write TypeScript or JavaScript online in a safe and sharable way.

www.typescriptlang.org

1 1

souporserious.com @souporserious.com · Jun 25

This will be a much nicer onboarding experience overall, thank you for contributing all of these fixes! 🙏

2

souporserious.com @souporserious.com · Jun 24

So exciting! I felt like this was always a huge hinderance to adopting MDX in App Router.

1 1

souporserious.com @souporserious.com · May 28

Reminds me of this vv.xyz/ideas/12b00e...

Mastery Hides Labor

At clarity, effort vanishes. Friction is gone. Genius looks obvious. That invisibility is the work.

vv.xyz

2

souporserious.com @souporserious.com · May 25

Made a small CLI that does exactly this that makes it a little easier github.com/souporseriou...

GitHub - souporserious/packlink: A simple and reliable way to test pnpm packages locally without publishing.

A simple and reliable way to test pnpm packages locally without publishing. - souporserious/packlink

github.com

3

souporserious.com @souporserious.com · May 23

The new Chinese American Bear EP. It's slowed down versions of their previous songs, but it's good. open.spotify.com/album/0rCKf5...

Waaaaaaaah!!!

Chinese American Bear · EP · 2025 · 6 songs

open.spotify.com

souporserious.com @souporserious.com · May 22

I don't think that's exclusive to RSC, we've always needed to guard those calls with something like "typeof document !== undefined" if it is initially server rendered.

1

souporserious.com @souporserious.com · May 22

github.com/souporseriou...

GitHub - souporserious/renoun: The Documentation Toolkit for React

The Documentation Toolkit for React. Contribute to souporserious/renoun development by creating an account on GitHub.

github.com

3

souporserious.com @souporserious.com · Apr 11

Love this! I've wanted to explore variants for posts like a free version and then more in-depth paid version. It's more work obviously, but thinking there would be more incentive to go deeper.

1

souporserious.com @souporserious.com · Mar 25

Just implemented this on one of my projects and it cleaned up so much, thank you!

2

souporserious.com @souporserious.com · Mar 25

More on structures here ts-morph.com/manipulation...

ts-morph - Structures

ts-morph.com

1 1

souporserious.com @souporserious.com · Mar 25

Yeah, sorry tsxmod isn't really helpful yet. You can code golf with a chat app, but if I understand what you're after you probably want to use structures and prune out any info you don't care about. Whipped up something to start with here stackblitz.com/edit/stackbl...

ts-morph navigation - StackBlitz

Starter project for Node.js, a JavaScript runtime built on Chrome's V8 JavaScript engine

stackblitz.com

1

souporserious.com @souporserious.com · Mar 24

never finished this project, but you can play with ts-morph here fairly quick to get an idea www.tsxmod.com

www.tsxmod.com

1

souporserious.com @souporserious.com · Mar 24

you want ts-morph ts-morph.com/navigation/

ts-morph - Navigating the AST

ts-morph.com

1

souporserious.com @souporserious.com · Jan 3

Haha yeah need to finally start posting over here!

1

souporserious.com @souporserious.com · Jan 3

Appreciate the kind words and shoutout, Josh! Happy New Year 🎊

2

souporserious.com @souporserious.com · Dec 30

This also works great for "duplicate" class methods where you can set default private field values:

class Counter {
#count = 0

duplicate() {
const counter = new Counter()
counter.#count = this.#count
return counter
}
}

souporserious.com @souporserious.com · Dec 22

I just use the TypeScript cli nowadays which has been refreshingly simple.

2