TypeScript-DOM-lib-generator icon indicating copy to clipboard operation
TypeScript-DOM-lib-generator copied to clipboard

Split addedTypes/overridingTypes/removedTypes by topics

Open saschanaz opened this issue 8 months ago • 3 comments

I don't think monolithic files help much. Smaller topic-by-topic files would help understanding why they exist, e.g. Streams customization can go into "streams" topic.

Given this will add new files, I'd like to try KDL for new ones than having to use JSON.

saschanaz avatar Jun 28 '25 23:06 saschanaz

Hello @saschanaz KDL seems cool. Can I try to migrate it, or this is still for discussion?

Bashamega avatar Jun 30 '25 11:06 Bashamega

I was planning to do this only when we have to add a new set up customization, but given we already have PRs like #2050 maybe we should try this before that, so that we can tell others to use it.

So yes, 👍🏻 from me

saschanaz avatar Jun 30 '25 12:06 saschanaz

Why KDL - it's mature enough (has been there for years), recently embraced by bikeshed (the web spec generator that over half of the specs depend on), has types so that we can do this:

interface Foo {
  method bar returns=DOMString {
    param p1 type=DOMPoint
  }
  property baz returns=short
}

(Our input data was migrated from XML which is why it's still XML-ish with .properties.property, I think KDL fits better for that.

saschanaz avatar Jun 30 '25 12:06 saschanaz