Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Interested in TypeScript definitions? #566

Open
wkillerud opened this issue Apr 13, 2022 · 2 comments
Open

Interested in TypeScript definitions? #566

wkillerud opened this issue Apr 13, 2022 · 2 comments

Comments

@wkillerud
Copy link

Hello!

I have begun making a TypeScript definition file in mrmlnc/vscode-scss#156 for a proof of concept that uses sassdoc.parse to show docs in VS Code.

I would like to expand the type definition to cover the rest of SassDoc, and was wondering if you'd be interested in shipping TypeScript definitions with this package?

In practice it means:

  • package.json will have a new types property pointing to the definition file
  • the definition file is included in the published package via the files property
  • any changes to the JavaScript API should ideally include an updated definition file going forward – I'll be happy to help maintain them

I can also publish a package through DefinetlyTyped if you'd rather not include it here. Co-location makes it easier to say in sync though.

@pascalduez
Copy link
Member

Hello,

I see no objections for adding a definitions file and shipping it.
Basically we should wait for other maintainers validation.
Don't hesitate to ping use again if it takes too long.

@wkillerud
Copy link
Author

Hey @pascalduez. Just checking in on this 😄

I've been working on improving the SassDoc integration on wkillerud/vscode-scss. I ended up building a library in TypeScript with just the parser to reduce the bundle size for the extension. sassdoc brings in the theme stuff, which was overkill for my needs.

That said, I'd still love to contribute type definitions for sassdoc and scss-comment-parser. I think I'm about 85%-90% there already on the branch feat/types linked below:

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Development

No branches or pull requests

2 participants