feat(styles-loader): disable purgecss by default

packages/one-app-bundler/README.md

@@ -277,6 +277,22 @@ You can pass only one if you wish to customize a single build target.
 
 #### [`purgecss`](https://github.com/FullHuman/purgecss) Options
 
+`purgecss` is an opt-in optimization that can reduce the overall bundle size of your module by
+eliminating unused css from your module's bundle. You can enable `purgecss` by setting
+`bundler.purgecss.enabled` to `true` in the `one-amex` key in your module's `package.json`:
+
+```json
+{
+  "one-amex": {
+    "bundler": {
+      "purgecss": {
+        "enabled": true
+      }
+    }
+  }
+}
+```
+
 You may add additional paths for `purgecss` to consider before stripping out
 unused CSS by adding an array of glob patterns to `bundler.purgecss.paths`
 under `bundler.purgecss.paths`. The example below illustrates how we would add
@@ -287,6 +303,7 @@ under `bundler.purgecss.paths`. The example below illustrates how we would add
   "one-amex": {
     "bundler": {
       "purgecss": {
+        "enabled": true,
         "paths": ["node_modules/some-lib/src/**/*.{js,jsx}"]
       }
     }
@@ -302,6 +319,7 @@ before enabling any of the following:
   "one-amex": {
     "bundler": {
       "purgecss": {
+        "enabled": true,
         "paths": ["node_modules/some-lib/src/**/*.{js,jsx}"],
         "extractors": [{
           "extractor": "purgeJs",
@@ -329,6 +347,7 @@ before enabling any of the following:
   "one-amex": {
     "bundler": {
       "purgecss": {
+        "enabled": true,
         "paths": ["node_modules/some-lib/src/**/*.{js,jsx}"],
         "extractors": [{
           "extractor": "purgeJs",
@@ -353,23 +372,6 @@ before enabling any of the following:
 }
 ```
 
-##### Disabling purgecss
-
-`purgecss` can be disabled for your module by adding
-`bundler.purgecss.disabled` as `true`. **Disabling purgecss entirely may increase your module bundle size and decrease performance.**
-
-```json
-{
-  "one-amex": {
-    "bundler": {
-      "purgecss": {
-        "disabled": true
-      }
-    }
-  }
-}
-```
-
 #### Legacy browser support
 
 `disableDevelopmentLegacyBundle` can be added to your bundler config and set to *true* to opt out of bundling the `legacy` assets. This will reduce bundle size and build times. This is only configured to be removed when in `development`. `production`  builds will not skip the `legacy` build.

packages/one-app-bundler/package.json

@@ -42,7 +42,6 @@
   "dependencies": {
     "@americanexpress/one-app-dev-bundler": "^1.7.0",
     "@americanexpress/one-app-locale-bundler": "^6.6.0",
-    "@americanexpress/purgecss-loader": "4.0.0",
     "@babel/core": "^7.22.20",
     "ajv": "^8.12.0",
     "assert": "^2.1.0",

packages/one-app-bundler/utils/validation/index.js

@@ -59,6 +59,7 @@ export const purgecssSchema = Joi.object({
   blocklist: Joi.array().items(Joi.string().required()),
   /* eslint-enable inclusive-language/use-inclusive-words -- disables require enables */
   disabled: Joi.boolean().strict(),
+  enabled: Joi.boolean().strict(),
 });
 
 const optionsSchema = Joi.object({