migration.md

Migrating to v4.0.0

This release contains breaking changes. We know these can be disruptive, but they were needed to keep the dependencies updated.

using Node 17+

breaking changes may also affect you:

• webpack output uses crypto.createHash that utilize MD4 of a OpenSSL 3.0 Legacy provider

Those You will see this error:

[webpack-cli] Error: error:0308010C:digital envelope routines::unsupported
    at new Hash (node:internal/crypto/hash:67:19)

Workaround one:

// uses a new hash function
// at output.config or at .febuild output property
{
  hashFunction: "xxhash64"
}

Workaround two:

# At your terminal, profile or before your build function run / use
export NODE_OPTIONS=--openssl-legacy-provider; 

ESlint ^8

Build now uses eslint-webpack-plugin intead of deprecated eslint-loader It's setting the plugin now instead of loader then

breaking changes

• review your .febuild exported eslint property to use only the eslint options schema

Stylelint ^15

We recommend extending a shared configuration like @netcentric/stylelint-config that includes the appropriate syntax to lint Scss.

Three breaking changes may also affect you: - Upgrade @netcentric/stylelint-config to "^2.0.0", - removed processors configuration property - removed support for Node.js 12 - changed overrides.extends behavior

Webpack ^5 and babel v7

Please review your webpack config options accordenly

• Review package.json dependecies on your project to match current one
• review babel configs to respect babel v7
• review your .febuild exported properties to use webpack latest options
  • stats
  • cache
  • devServer
  • performance
  • resolve
  • optimization
  • plugins

Migrating to v2.0.0

This release contains breaking changes. We know these can be disruptive, but they were needed to keep the dependencies updated.

Stylelint v14 does not longer includes the syntaxes that parse CSS-like languages like Scss. You will need to install and configure these syntaxes in your project. We recommend extending a shared configuration like @netcentric/stylelint-config that includes the appropriate syntax to lint Scss.

First, install the shared configuration as a dependency:

npm install --save-dev @netcentric/stylelint-config

Then, update your Stylelint configuration object to use it:

{
  "extends": "@netcentric/stylelint-config",
  "rules": {
    ...
  }
}