Skip to content

Conversation

@mdmower-csnw
Copy link
Contributor

@mdmower-csnw mdmower-csnw commented Feb 6, 2025

This pull request builds on top of #159. Once that pull request is merged into develop, this PR will be updated and those changes will disappear from the file changes.

Summary

Add support for configuring sass-embedded options. This improves this flexibility of uswds-compile for consumers.

  • Add sassOptions to settings.compile.
    • Include type hints from sass-embedded Options. Until @types/gulp-sass is updated for v6, this is more correct than using GulpSassOptions from @types/gulp-sass which is based on node-sass.
    • Indicate default options that will apply unless overridden.
    • If loadPaths are defined, watch these paths for changes when the watch script is running.
  • Deprecate (but still support) sassDeprecationWarnings.
    • Include JSDoc deprecation notice.
  • Better support SASS option style when set to expanded to avoid running CSSO minification. This improves source map reliability.
  • Update readme.

Related issue

Closes #133
Closes #80
Closes #59

Testing and review

A testing pull request has been prepared for the sandbox: uswds/uswds-sandbox#180 . Sample tests to get you started are included in that PR description.

thisisdano and others added 4 commits January 5, 2025 00:50
- Add `sassOptions` to `settings.compile`.
  - Include type hints from `sass-embedded` Options. Until
    `@types/gulp-sass` is updated for v6, this is more correct than
    using `GulpSassOptions` from `@types/gulp-sass` which is based on
    `node-sass`.
  - Indicate default options that will apply unless overridden.
- Deprecate (but still support) `sassDeprecationWarnings`.
  - Include JSDoc deprecation notice.
- Better support SASS option `style` when set to `expanded` to avoid
  running CSSO minification. This improves source map reliability.
- Watch `loadPaths` for changes.
@mdmower-csnw mdmower-csnw changed the base branch from dw-gulp-sass-update to develop December 15, 2025 20:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants