bug: generated documentation does not display custom properties when included in loud comments

[duhem-s]

Prerequisites

• I have read the Contributing Guidelines.
• I agree to follow the Code of Conduct.
• I have searched for existing issues that already report this problem, without success.

Stencil Version

v4.14.0

Current Behavior

When I document custom CSS properties using syntax within loud comments in my CSS files, the generated documentation does not display them.

In Sass, to preserve comments we have to set them as loud comments using the following format:

/*!
 * @prop --mg-badge-size: Badge size
 */

https://sass-lang.com/documentation/syntax/comments/#in-scss

However, these loud comments do not seem to be interpreted by the documentation generation process.

Expected Behavior

I expect the documentation to display the --mg-badge-size custom property with its associated description, indicating that it represents the badge size.

System Info

No response

Steps to Reproduce

Add loud comment in CSS like: https://github.com/duhem-s/stencil-css/blob/main/src/components/my-component/my-component.css

Run build command.

Custom properties are not displayed in readme.

Code Reproduction URL

https://github.com/duhem-s/stencil-css/tree/main

Additional Information

No response

[rwaskiewicz]

Thanks for the issue + reproduction case! I verified that Stencil can "see" comments that begin with a /*!, but it's currently not doing anything with them. I'm going to label this to get it added to our backlog.

Thanks again!

[rwaskiewicz]

The fix for this issue was included in today's release of Stencil v4.17.2