feat: Include the sourceMappingURL & sourceURL when toString()

[asnowwolf]

What kind of change does this PR introduce?

feature

Did you add tests for your changes?

yes

If relevant, did you update the README?

no

Summary

This feature is useful when you need to pass the result of css-loader to angular: call to require('to-string-loader!css-loader? sourceMap!sass-loader?sourceMap!./ test.scss') will include source mapping, And finally assigned to the component's styles metadata

Does this PR introduce a breaking change?

I think no, Unless some code assumes that the css content does not have source maps

Other information

It's useful to angular component style.

[asnowwolf]

I did not receive the e-mail for sign CLA, could you please re-send it? @sokra @d3viant0ne @kennyt

[joshwiens]

@asnowwolf - Close & Open a new Pull Request. That should trigger the CLA system to send it again.

[codecov]

Codecov Report

Merging #417 into master will increase coverage by 0.04%.
The diff coverage is 100%.

@@            Coverage Diff            @@
##           master    #417      +/-   ##
=========================================
+ Coverage   98.36%   98.4%   +0.04%     
=========================================
  Files           9       9              
  Lines         306     314       +8     
  Branches       69      71       +2     
=========================================
+ Hits          301     309       +8     
  Misses          5       5

Impacted Files	Coverage Δ
lib/css-base.js	97.14% <100%> (+0.84%)	✅

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 476a927...23eea3d. Read the comment docs.

[asnowwolf]

I tried, but still no email sent to me... does the bot work properly?

[asnowwolf]

Could you please send me a CLA mail and I manually sign it?

[michael-ciniawsky]

@asnowwolf Can you please try again the CLA Bot should work now 😛

[joshwiens]

@asnowwolf - You will need to close & reopen this pull request to trigger the CLA assistant so it can be signed.

[ekulabuhov]

Is toString() a part of the public API? Should it be documented?

[jsf-clabot]

All committers have signed the CLA.

[asnowwolf]

@ekulabuhov oh, yes, it is. I'll try to fix the documents too.

[asnowwolf]

@ekulabuhov

Done.

But my english is not so good, please review it and modify it freely.

Thank you!

[asnowwolf]

If this PR is published to npm, please @ me here, some of other PRs are waiting for this one.

[joshwiens]

@michael-ciniawsky - This should be removed from the 1.0.0 milestone and published as a Minor as it's backwards compatible and beneficial to the community now.

Updating to defaults will take some time, no reason to hold this feature up.

[asnowwolf]

Oh, so... a standalone loader, eg. https://github.com/asnowwolf/css-with-mapping-loader, is more preferred?

[joshwiens]

@asnowwolf - No, that was just a comment on how we are going to release this to npm.

The pull request will be accepted & released before the coming semver MAJOR release that is in planning.

[asnowwolf]

Oh, I see!

[michael-ciniawsky]

@d3viant0ne Alright, yep the v1.0.0 Project is more for sorting, when it's getting real I definitely make a Milestone with timeline :D

[michael-ciniawsky]

@asnowwolf Thx 😛

[ekulabuhov]

@asnowwolf Thank you! That's perfect 👍