Originally created by: xzyfer
Originally owned by: saper
Current WIP: https://github.com/sass/node-sass/pull/2312
We have been planning to release node-sass@v5 with LibSass 3.5.0 stable when it's ready. With a 5.0 milestone on the horizon we want to take note of the breaking changes we're planning to make.
This is living, and incomplete. Please subscribe for updates.
Moving forward we'll only be actively supporting active LTS and current Node versions. In practical terms this means Node 6+.
See [#2290]
See [#2286]
See [#2257]
See [#2170]
See [#2256]
See [#2205]
See [#2288]
...the list goes on
Why? Because Gaze in docker and various virtual machines uses a lot of resources whereas chokidar does not. Read about the advantages of chokidar
[...] in docker for mac you will get really high CPU usage with com.docker.hyperkit and com.docker.osxfs (I've seen reports of up to 300%).
See [#2208]
When using the watch flag we should do a compilation before watching.
This becoming the expected behaviour in JS (see webpack).
See https://github.com/sass/node-sass/issues/2300
See https://github.com/sass/node-sass/issues/1973
See https://github.com/sass/node-sass/issues/1369
See https://github.com/sass/node-sass/issues/1742
A LibSass has a feature/bug that allows it to @import
.css files.
This means our watcher must also watch for .css files.
This can cause infinite loops if the input and out directories are the same.
LibSass is deprecating this behaviour.
See https://github.com/sass/libsass/issues/2611
See [#2184]
See [#2006]
See [#1933]
See [#1925]
See [#1867]
See [#1845]
In order to reduce issues about installation issues we failed the installation if we detected an environment we didn't provide binaries for.
This had the intended affect, but also had some unfortunate side-effects
- difficult or impossible to install on environments that could fallback to local compilation i.e. arm, electron
- required a version bump when new version of node landed
- couldn't back port support for new Node versions
In v5 we should still produce an informative error, but allow the installation to continue.
Originally posted by: nschonni
For the node support version here is my proposal. Since Node publishes their LTS and dev branch timeline on https://github.com/nodejs/Release#lts_schedule
- LTS minus 2 months, start spitting a warning on install warning that support is running out
- LTS expired + 2 months, only allow install through a flag(
--unsupporting-lts-bypass
?), but warn no issues will be fixed- Dev/Odd number branches are no longer installable after new LTS branch date
- Add curl/wget commands to the output for those that just can't/won't update
Not suggesting that binaries are removed after the LTS expiry, just that our install/download will error out and tell users to upgrade. This may change a little if/when WebAssembly is available, but I'm not going to assume that's a 5.x thing.
Originally posted by: nschonni
I think dropping/simplifying the binary options would also be a good idea. Just replace them with some curl/wget commands. Alternately, some instructions on symlinking for those that want the old site-layout style.
Originally posted by: nschonni
Maybe take a look at
node-pre-gyp
again as it looks like someone setup a GH releases piece https://github.com/bchr02/node-pre-gyp-githubOriginally posted by: nschonni
Looks like node-pre-gyp doesn't have download caching right now, but there is a PR pending https://github.com/mapbox/node-pre-gyp/pull/272
Originally posted by: bruce-one
Just fyi, this repo supports node-pre-gyp for node-sass and publishes to github: https://github.com/bruce-one/node-sass (the binaries can be seen on the releases page). Eg
npm i bruce-one/node-sass
with node 8 installs using the binaries off github for me.Just if of interest (never quite got round to making a PR :-s it's not very complicated though :-) also, fyi, the commit history is a mess because of trying to force travis builds. The diff isn't all that much.)
Originally posted by: nschonni
@bruce-one thanks! looks good, think we'd clean out a bunch of our custom SASS_BINARY stuff if we implement that. Also could rename the
binding.node
to the more standardnode_sass.binding
too. I won't do my own PR for now, but I'll ping you when we're ready for this 😄Originally posted by: xzyfer
We considered pre gyp for a long time but at the time it only supported
Windows/Linux/OSX builds. It was non-trival to add freebsd and might have
tied outlet hands with alpine, electron and potentially and support. Maybe
that has changed now. It's been over a year since we've looked seriously
On 2 Nov. 2017 4:02 pm, "Nick Schonning" notifications@github.com wrote:
Originally posted by: xzyfer
Platform support has been improved, but still doesn't match our supported platforms. Looks like there's also not support for electron or musl which is a bummer.
Maybe we could look at PRing musl.
Originally posted by: nschonni
https://github.com/mapbox/node-pre-gyp#versioning
Originally posted by: bruce-one
I believe Electron support is handled via the
runtime
property rather thanplatform
, and from what I know node-pre-gyp is used by Electron projects.Originally posted by: xzyfer
Awesome. Let's take a look! I only skimmed the docs over breakfast.
On 3 Nov. 2017 8:23 am, "bruce-one" notifications@github.com wrote:
Originally posted by: surfaceowl
Even though tunnel-agent is only used for internal build per this closed issue, it would be helpful if request were upgraded >2.83.0 in node-sass@v5.
Package vulnerability scanners don't differentiate between packages used only for install vs. runtime... which means we have to mentally keep track of 'this one is okay' for tunnel-agent under node-sass / requests.
Would be great if this dependency upgrade could be included.
Originally posted by: nschonni
@surfaceowl I would like to remove request completely and use
node-pre-gyp
for 5, but I haven't looked to see if it is using request under the hood 😉Originally posted by: realityking
@nschonni It is. Locked to 2.81.0.
Originally posted by: surfaceowl
@nschonni -- that would help. Even though
node-pre-gyp
still usesrequest 2.81.0
it eliminates the current package vulnerability.Originally posted by: xzyfer
Update the issue description with additional changes in v5.
Originally posted by: xzyfer
Work on this has begin in https://github.com/sass/node-sass/pull/2312
Originally posted by: nschonni
@bruce-one we've created the
v5
branch now if you want to PR yournode-pre-gyp
stuff now ❤️Originally posted by: xzyfer
I'm growing concerned that the Active LTS and Current support target may be
- complicated to communicate, and
- too aggressive
Looking at our release binary download stats, Node 4 (46) is getting a significant number of downloads.
We're forced to drop Node < 4 due to our dependencies. And we agree that using Node < 4 is unsafe and should be discouraged.
There are some Node milestones coming up in April
- Node 4 reaches EOL on the 30th, and
- Node 10 is due to be stable on the 24th
Given that we want to get a final 4.x release out with a LibSass bump. We should take this opportunity to add the Node 10 binaries, and monitor the release binary download numbers.
With any luck there will be a significant drop off in Node 4 installs. If not I would be more comfortable aiming for Node >= 4 support.
Reference
You can see the download stats with the following query in GitHub's GraphQL API explorer.
Originally posted by: realityking
I crunched the numbers for one release (4.7.2 to be exact) really quick. This might warrant digging a bit more (e.g. more release), so here's the code: https://gist.github.com/realityking/5f29d001ed96f1e9e6a318bb71122508
The result I got is this:
I'll leave the decision-making to others 😄
Originally posted by: jeroensmit
Is there a release date/roadmap?
How can we as a community help to release v5 and with that help to remove the outdated (and vulnerable) dependencies?