Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

feat: create a 'web-types' doc output target #5460

Closed
3 tasks done
duhem-s opened this issue Mar 12, 2024 · 5 comments
Closed
3 tasks done

feat: create a 'web-types' doc output target #5460

duhem-s opened this issue Mar 12, 2024 · 5 comments
Labels
Resolution: Refine This PR is marked for Jira refinement. We're not working on it - we're talking it through.

Comments

@duhem-s
Copy link

duhem-s commented Mar 12, 2024

Prerequisites

Describe the Feature Request

I would like to propose the addition of a new feature to Stencil, which is the ability to export web-types alongside the existing VS Code documentation export.

Describe the Use Case

Currently, Stencil provides an export feature for VS Code documentation, which is immensely helpful for providing auto-completion and documentation support within VS Code. However, it would be beneficial to extend this functionality to include web-types, which would facilitate auto-completion and documentation support in other IDEs such as WebStorm.

Describe Preferred Solution

I envision the preferred solution as an enhancement to the existing Stencil build system to generate web-types metadata in addition to the current VS Code documentation. This could be achieved by introducing a new build target that generates web-types-compatible metadata files alongside the existing VS Code documentation files. This feature would greatly enhance the usability of Stencil components across a wider range of development environments.

Describe Alternatives

No response

Related Code

No response

Additional Information

No response

@ionitron-bot ionitron-bot bot added the triage label Mar 12, 2024
@rwaskiewicz rwaskiewicz added the Resolution: Refine This PR is marked for Jira refinement. We're not working on it - we're talking it through. label Mar 12, 2024
@ionitron-bot ionitron-bot bot removed the triage label Mar 12, 2024
@rwaskiewicz
Copy link
Member

Thanks! I've marked this to ingest it into our internal backlog

@rwaskiewicz
Copy link
Member

As a hack day project, I created https://github.com/stencil-community/stencil-web-types. Feel free to give that go! Feedback welcome!

@duhem-s
Copy link
Author

duhem-s commented Apr 23, 2024

As a hack day project, I created https://github.com/stencil-community/stencil-web-types. Feel free to give that go! Feedback welcome!

Looks nice, thanks for the project.
Now I'm wondering why this is not included in Stencil builds since it provides a vscode build.

@rwaskiewicz
Copy link
Member

Now I'm wondering why this is not included in Stencil builds since it provides a vscode build.

The reason it's not in Stencil today is that it's still early on/experimental. I'm maintaining it as a hack day project (I'll be working on it again in ~3 weeks for our next hack days). If folks are actively using it, we'll probably fold it into Stencil Core at some point.

@christian-bromann
Copy link
Member

Thanks @rwaskiewicz for contributing this awesome plugin! Let's continue further discussions in that project. So if anyone runs into issues or would like to add features, raise an issue there and we can take it from there.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Resolution: Refine This PR is marked for Jira refinement. We're not working on it - we're talking it through.
Projects
None yet
Development

No branches or pull requests

3 participants