You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This follows on some thoughts I had in the stylelint chat.
/cc @stylelint/core
So, I believe that the primary use case for this project is to provide meaningful feedback to a developer about incorrect CSS, and so stylelint is the best fit for it. Of course, I have my own use case of being able to check validity of CSS properties before merging, but primarily I think stylelint benefits the most from this work. With this in mind, I think we need to discuss how we can integrate this into stylelint!
I am now thinking of not exposing any of the templating/generation that we do in the background, it's just not necessary for the two main use cases that I've outlined (and, it took me a while to see @davidtheclark's logic for not doing this). Instead, css-values will exist as a module on npm which you can require, and won't do any CSS parsing beyond using postcss-value-parser; you will be able to use it to return a warning message or true if the value passed validation.
importcssValuesfrom'css-values';/** * @param {string} Property to validate * @param {string|valueParser} Value to validate */constvalid=cssValues('color','blue');// => trueconstinvalid=cssValues('color','yrllow');// => {message: '"yrllow" is not a valid value for "color".'}
To facilitate this I think we need to move to a monorepo which houses:
The css-values module itself;
A stylelint plugin which wraps the css-values functionality;
A PostCSS plugin which wraps the css-values functionality;
and any future module which depends on code/tests from this project.
One of the areas that I've already identified as needing improvements is the lack of feedback from the module on an invalid value. It seems like something that can be addressed fairly easily by changing the return value (in the invalid case) of a lot of the different validator functions. So, if you'd like to contribute then this is a really good way to do so!
Please let me know if you have any questions/suggestions/feedback, it really helps! 😄
We were anticipating the stylelint plugin being called stylelint-declaration-no-valid. The plugin might need to detect non-standard syntax (variable interpolations, dollar variables etc) and ignore declarations that contains that for their property and/or value. Other than that, I suspect the plugin will simply walk the declarations calling cssValues on each.
@jeddy3 Did you mean stylelint-declaration-no-invalid?
Ignoring things like string interpolation and variables in the consuming plugin is probably easiest, but it might be worth adding support still as long as this behaviour was opt-in. That facilitates this use case;
h1 {
color: hsl($hue, $sat, $light, $alpha); // Error: Too many arguments passed to `hsl`. Expected 3.
}
Although, it shouldn't try to validate mixins that are not part of CSS syntax. I'd like validation to occur on a property/value pair, and leave more sophisticated static analysis up to other plugins.
Personally I am not using Sass syntax so I would welcome support for this feature from somebody who would be willing to maintain this.
Activity
davidtheclark commentedon Aug 6, 2016
This sounds like a great plan to me, both in terms of the API for a
css-valuesmodule and the monorepo organization.jeddy3 commentedon Aug 6, 2016
Agreed. Sounds great!
We were anticipating the stylelint plugin being called
stylelint-declaration-no-valid. The plugin might need to detect non-standard syntax (variable interpolations, dollar variables etc) and ignore declarations that contains that for their property and/or value. Other than that, I suspect the plugin will simply walk the declarations callingcssValueson each.ben-eb commentedon Aug 8, 2016
@jeddy3 Did you mean
stylelint-declaration-no-invalid?Ignoring things like string interpolation and variables in the consuming plugin is probably easiest, but it might be worth adding support still as long as this behaviour was opt-in. That facilitates this use case;
Although, it shouldn't try to validate mixins that are not part of CSS syntax. I'd like validation to occur on a property/value pair, and leave more sophisticated static analysis up to other plugins.
Personally I am not using Sass syntax so I would welcome support for this feature from somebody who would be willing to maintain this.
jeddy3 commentedon Aug 8, 2016
Ha, yes I did :)
That would be nice.
Same. Hopefully someone will step up though.
ben-eb commentedon Aug 31, 2016
0.1.0 is now out on npm if you'd like to have a play with it. 😄
ben-eb commentedon Aug 31, 2016
#26 is also really relevant for stylelint's use case. 😄