Update typedoc

[justinfagnani]

I'm doing this upgrade as a first step to try to get closer to API docs for labs packages like context, and because it'll likely be necessary at some point with TypeScript updates. TypeDoc 0.23 seems to have some better monorepo support.

There were some breaking changes that I think I got through. I looked through some API pages, but not all, and they seem fine so far. Will look at more soon.

The built JSON files are quite different, so they're going to be hard to review. I do wonder if we want stop regenerating the lit-html-1 and lit-element-2 data files so that we don't have to worry about changes to typedoc being incompatible with older jsdoc comment styles or older TypeScript source.

[github-actions]

A live preview of this PR will be available at the URL(s) below.
The latest URL will be appended to this comment on each push.
Each build takes ~5-10 minutes, and will 404 until finished.

https://pr1041-9e72d17---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-b8d7a41---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-6cc8f3f---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-bcb4967---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-a42ca12---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-3e80b7c---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-4d6102c---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-78fe77b---lit-dev-5ftespv5na-uc.a.run.app/
https://pr1041-81149b9---lit-dev-5ftespv5na-uc.a.run.app/

[justinfagnani]

So the Check API data in sync approach no longer works with [email protected] because the output isn't stable. There's a target property on a bunch of node that looks like an integer ID. If we want to make sure the file is roughly "the same" we'll have to do some custom processing. @aomarks

[justinfagnani]

Somehow the directives/ page isn't being generated.

[aomarks]

So the Check API data in sync approach no longer works with [email protected] because the output isn't stable. There's a target property on a bunch of node that looks like an integer ID. If we want to make sure the file is roughly "the same" we'll have to do some custom processing. @aomarks

Can we just delete the target property?

[justinfagnani]

@aomarks

Can we just delete the target property?

Maybe? If we don't use that to generate the docs. I'll try.

[justinfagnani]

@aomarks I didn't realize we were already pruning so many properties. I added 'target' to the list and we'll see if things render properly.

[justinfagnani]

@aomarks that worked!

[justinfagnani]

Right now the import locations are broken. They're rendering as:

import { LitElement } from '';

fwiw, I was able to get some labs/contexts docs rendering as a follow-on.

[AndrewJakubowicz]

This is superseded by #1093 and also #1093.

Thank you for providing a great reference to build on!