@zohodesk/react-cli 1.1.1 → 1.1.2-9.exp.3

package/.vscode/settings.json

@@ -0,0 +1,25 @@
+{
+    "cSpell.words": [
+        "classname",
+        "cmjs",
+        "devbuild",
+        "escodegen",
+        "expublish",
+        "gitclone",
+        "hgclone",
+        "mockapi",
+        "mockserver",
+        "nowatchserver",
+        "nowatchstart",
+        "postpublish",
+        "propertytojson",
+        "sslcert",
+        "sslcertupdate",
+        "sstest",
+        "uglifycss",
+        "valuereplacer",
+        "xmlhttprequest",
+        "zohodesk",
+        "zsecurity"
+    ]
+}

package/README.md

@@ -44,70 +44,475 @@ Now to run app
 
 # Change Logs
 
+# 1.1.28 (29-01-2025)
+
+**Fixes**
+
+   - We've changed the i18n Unicode conversion process. Instead of converting the Unicode at runtime, we now convert it to the corresponding language during the build process and emit the final build
+   - Added @zohodesk-private in transformIgnorePatterns in jest.config.js file , fix in jest
+   
+**changes**
+
+   - separate the disableES5Transpile flag as two flags disableES5Transpile and disableES5Import 
+   - disableES5Import flag handles the alias part 
+   - disableES5Transpile flag handles the esmodules or common modules conversion part 
+
+
+# 1.1.27 (16-12-2024)
+
+   -  While rendering i18n keys at runtime, we convert any keys containing Unicode to their corresponding language characters before rendering. This enhances performance and reduces file size.
+
+# 1.1.26 (06-09-2024)
+
+**Features**
+
+  - Add a new className format that mirrors the class names used in the source code.
+   ```
+    app: {
+      displayClassName: true
+    }
+   ```
+
+  - option given to disable the HtmlWebpackPlugin.
+   ```
+    app: {
+      generateHtml: true
+    }
+   ``` 
+  - Control the rendering order of async CSS chunks.
+  ```
+    css: {
+      enable: true,
+      className: <ID of the tag before which all async CSS chunks should be rendered.>
+    }
+    ```
+   
+
+# 1.1.25 (12-08-2024) 
+
+ - mp3 files support added
+
+# 1.1.24 (29-06-2024)
+
+- Worker loading logic fixes.
+
+# 1.1.23 (28-06-2024)
+
+**Features**
+
+  - alias feature added for library, application and jest. To enable it , configure your `react-cli.config.js` as below
+
+  ```
+     {
+      alias: {
+        "@components": './src/components, 
+      }
+     }
+  ```
+
+  - For devmapping  config jsConfig.json ad below 
+
+  ```
+    {
+      "compilerOptions": {
+        "baseUrl": ".",
+        "paths": {
+            "@components/*":   [ "./src/components/*"],
+        }
+      }
+    }
+  ```
+
+  - Customized Script loading strategy added. To enabled it, configure your `react-cli.config.js` as below
+
+      ```  
+          {
+            app: {
+              htmlTemplate: {
+                customScriptLoadingStrategey: {
+                  enable: true,
+                  options: {
+                    async: [/.*js$/],
+                    defer: [/^main.*\.js$/]
+                  }
+                }
+              }
+            }
+          }
+      ```
+
+**Changes**
+
+  - Worker loading logic
+
+# 1.1.22 (6-6-2024) 
+
+**Changes** 
+
+  - Bug fix in Typescript
+
+# 1.1.21 (4-6-2024)
+
+- TypeScript support has been added for the application, library, and Jest.
+
+- The `enable_typescript` option has been added in the react-cli.config.js. Set it to true to enable TypeScript
+
+- Support for adding plugins is now available. To use this, configure your react-cli.config.js file as follows:
+
+   ```
+      babelCustomizationForLibrary: {
+        babelPlugins: [<`your plugins`>]
+      },
+   ```
+- The Memory leak issue while downloading i18n and CSS files has been fixed
+
+
+# 1.1.20-exp.1
+
+**Changes**
+
+- Added memory leak fixes for script, links tags
+
+**Feature**
+- Custom Script loading strategy support for initial html script tags.
+
+# 1.1.19-exp.18
+
+**Changes**
+
+- To do further build size optimization by utilizing webpack provided config.
+
+```
+  innerGraph: true,
+  usedExports: true,
+  sideEffects: true
+```
+
+# 1.1.20 (27-5-2024)
+
+**Feature**
+
+- enhancedReactLiveConverter.js added and imported in  docLoader file
+
+- stats.json file creation deleted, if `enable_stats` option is false.
+
+# 1.1.19 (5-2-2024)
+
+**Feature:-**
+
+- Added config to remove additon of `babel/react` extend code for 'spread' operator usage on JSX.
+
+# 1.1.18 (30-01-2024)
+
+**Feature:-**
+
+- MJS loader support added.
+- We can enable/disable this feature by `npm run start --enableMjsLoader=true/false` default value will be `false`.
+ 
+```
+app: {
+  enableMjsLoader : true/false
+}
+```
+
+# 1.1.17 (24.1.2024)
+
+**Feature:-**
+
+- Updated browser data used for querying target browsers, which lead to reduced polyfills in our bundle.
+
+```
+npm run updateTargetBrowserVersions // to update browser targets
+```
+
+**Fixes**
+
+- added prop types removal for es6 bundling, which is missed.
+
+# 1.1.16 (25-10-2023)
+
+**Feature:-**
+
+- Support for running devURL in a Kubernetes (k8s) environment has been added.
+
+In order to support k8's, we need to the change the server url:- 
+
+Follow the below steps to enable support for k8's in your app:-
+
+  1.Add the following config in your react-cli.config.js file:-
+ 
+```
+app: {
+  server: {
+    domain : 'kubernetes'
+  }
+}
+```
+
+# 1.1.15 (11-10-2023)
+
+**Feature:-**
+
+- externals was added to  Prevent bundling of certain imported packages and retrieve these external dependencies at runtime.
+- to use externals, we use the following pattern in `app > externals` :
+
+For example
+```
+   externals: {
+    <key> : <value>
+   }
+```
+# 1.1.14 (11-9-2023)
+
+**Feature:-**
+
+- Value Replacer supports `^` before and `$` after the word to consider the whole word for replacement. Only if the exact word comes as value, there will be a replacement made.
+
+**Issue Fix**
+
+- 'space' character on variable conversion changes to undefined fixed.
+- calc(100%) variable conversion to undefined fixed.
+- height value if text converts to undefined, issue fixed.
+
+# 1.1.13 (4-9-2023)
+
+**Changes**
+
+- Fixed the issue related to the resource cleanup plugin. (EfcResouceCleanupPlugin)
+
+
+# 1.1.12 (1-9-2023)
+
+**Features**
+
+- Generating stats.json file for the build assets only in production mode. To use this feature we need to add `stats > enable` or cli flags `enable_stats`.
+- Added Resource Cleanup plugin to cleanup resource retained by build tool. this plugin is controlled by custom attributes enable flag.
+
+**Changes**
+
+- Added a new config `stats` to control stats file generation.
+- Using Existing custom attributes flag, we can control resource cleanup plugin.
+
+# 1.1.11 (4-8-2023)
+
+**Changes**
+
+- we have renamed our default config file as `react-cli.config.js` instead of `build.config.js`. But we still support `build.config.js` we will remove it in later major version.
+
+- Prop-type, Prop description, Default Props support for docs given.
+- Docs and Docs_Code UI updated.
+
+**Features:-**
+
+- custom classname prefix for separate packages now supported.
+- to use custom classnames for specific patterns, we use the following pattern in `app > customClassNamePrefix` or `docs > customClassNamePrefix` :
+
+```
+"customClassNamePrefix" : [
+  {
+    "enable": true,
+    "prefix": "[required-prefix]",
+    "patterns":[
+      "**/[path-name]/**/*.css"
+    ]
+  }
+]
+```
+
+For example,
+
+```
+"customClassNamePrefix": [
+  {
+    "enable": true,
+    "prefix": "zdSvg",
+    "patterns": [
+      "**/@zohodesk/svg/**/*.css"
+    ]
+  },
+],
+```
+
+**Issue Fix:**
+
+- typo fix, (../src/common/runPreProcess.js) to (../lib/common/runPreProcess.js) in cli.js our code.
+
+# 1.1.10 (2-8-2023)
+
+**Issue Fix:**
+
+- undefined plugin postcss issue fixed for docs.
+- unnecessary deprecation warning stopped. (for exclude config)
+
+# 1.1.9 (25-7-2023)
+
+**Features:-**
+
+- we have added config file support for react-cli schema. the default config file name `build.config.js` support added. In `build.config.js` you must export configuration object under `config` key. And Note: `build.config.js` is high priority then `package.json` `react-cli` config.
+- added support for using regex expression to get group of chunks chunkId via Resource Hint plugin prefetch/preload hook.
+  only will be activate when `resourceHints` => `allowPrefetchingMultipleChunks` as `true`
+- added support for pattern as function for custom chunks split logic.
+- added options to split chunks base config in the key `app` => `customChunksBaseConfig` as object
+- added `postCssPluginOrder` feature :
+
+  - If `app > postCssPluginOrder` or `docs > postCssPluginOrder` is set to "false", default plugin order will be followed.
+  - If `app > postCssPluginOrder` or `docs > postCssPluginOrder` is set to "true", order preserved in `plugins` Object will be considered.
+  - If `app > postCssPluginOrder` or `docs > postCssPluginOrder` is set to an array with plugins in a custom order, the custom order will be considered.
+
+- We use the same plugin names as in `patterns` for the plugins to execute successfully.
+
+**Issue Fix**
+
+- fixed file path separator issue with split chunks config for vendor exclude list for windows (that was work well for mac and ubuntu only issue in windows).
+- fixed cssUniqueness pattern not working in docs.
+
+**Changes**
+
+- previously all custom chunks are enforce true, no we have given support for enforce false for chunks on splitChunks config.
+
+# 1.1.8
+
+**Issue Fix**
+
+- Docs fix for Selector Replace 'always require argument' issue.
+
+# 1.1.7
+
+**Feature**
+
+- Markdown parser feature added in docs
+  For more info please refer to :
+  [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/2.0.0/docs/MarkdownParser.md)
+
+# 1.1.6-exp.2
+
+- fixed file path separator issue with split chunks config for vendor exclude list.
+- added support for not doing enforce true for chunks on splitChunks config.
+
+# 1.1.5-exp.5
+
+- fixed the issues regarding custom chunks base config schema.
+
+# 1.1.5-exp.4
+
+- added support for using regex expression to get group of chunks chunkId via Resource Hint plugin prefetch/preload hook.
+
+# 1.1.5-exp.3
+
+- added options to split chunks base config
+- added support for passing custom chunks split logic as function.
+
+# 1.1.6
+
+**Issue Fix**
+
+- local install react-cli spawnSync Error fix in npm 8
+- babel version update issue fix (Cannot read properties of undefined (reading 'file')) and (BABEL_TRANSFORM_ERROR)
+
+# 1.1.5-exp.2
+
+**Issue Fix**
+
+- local install react-cli spawnSync Error fix in npm 8
+
+# 1.1.5
+
+**Issue Fix**
+
+- include pattern fix for variable converter plugin fixed
+
+# 1.1.4
+
+**Issue Fix**
+
+- global install react-cli spawnSync Error fix
+- `0px` variable value conversion issue fixed
+- pattern exclude for postcss plugins case fixed
+
+# 1.1.3
+
+**Issue Fix**
+
+- local install react-cli spawnSync Error fix
+
+# 1.1.2
+
+**Issue Fix**
+
+- ReactLiveConverter filepath changed to 'reactLiveConverter.js' in docLoader file
+
 # 1.1.1
 
 **Issue Fix**
+
 - docs component name incorrect in windows, when using --enableReactLive issue fixed.
 
-**Feature Update** 
+**Feature Update**
+
 - Support for desk-library to use Selector Replace plugin using individual script. To use `react-cli selectorReplacer [source] [target]`
 
 # 1.1.0
 
 **Feature Update**
-- Support for desk-library to use variable convertion plugin using individual script. To use `react-cli variableConverter [source] [target]`
+
+- Support for desk-library to use variable conversion plugin using individual script. To use `react-cli variableConverter [source] [target]`
 - pattern filter changes, new filter system instead of exclude to include or exclude files for plugins.
-For more info please refer to : 
-[details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/2.0.0/docs/patternFiltering.md)
+  For more info please refer to :
+  [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/2.0.0/docs/patternFiltering.md)
 - React Live feature implemented for Docs.
-[details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/2.0.0/docs/ReactLive.md)
+  [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/2.0.0/docs/ReactLive.md)
 
 # 1.0.3-beta.1
 
 **Issue Fix**
-- nock api not working issue fixed. This error throwing in @zohodesk/react-cli@1.0.2 version. but working in older versions ( 0.0.1-beta.178 )
 
+- nock api not working issue fixed. This error throwing in @zohodesk/react-cli@1.0.2 version. but working in older versions ( 0.0.1-beta.178 )
 
 # 1.0.3
 
 **Feature Update**
+
 - Support for global httpsCerts usage
 - Support for global client_packages_group usage
-- custom attribute for dynamically loading chunks, In this version we merged changes from [0.0.1-beta.167.1](#0.0.1-beta.167.1). 
-**Package Update**
-- @zohodesk/client_packages_group@**1.0.1** ==>  @zohodesk/client_packages_group@**1.0.2**  
-
-
+- custom attribute for dynamically loading chunks, In this version we merged changes from [0.0.1-beta.167.1](#0.0.1-beta.167.1).
+  **Package Update**
+- @zohodesk/client_packages_group@**1.0.1** ==> @zohodesk/client_packages_group@**1.0.2**
 
 # 1.0.2
 
 **Feature Update**
+
 - Selector replace plugin made as a custom postcss-plugin with update to code that was unpublished in package.
 
 # 1.0.1
 
 **Issue Fix**
+
 - variable conversion for px and var(--) values in same declaration was not supported, now it is supported.
 - package-lock.json removed from `.npmignore`
 
 **Feature Update**
+
 - exclude added to Selector Plugin
+
 # 1.0.0
+
 ## Major Release
+
 **Changes:**
+
 - File support added for `.webp` for `docs`, `dev` and `prod` mode
 - File support added for `.webm` for `docs`, `dev` and `prod` mode
 
 **Breaking Changes:**
 
-- We have remove ssl certificate for security reasons.  
-  So default https server won't run.  
-  In order to make it work as before you  need to specify two things
+- We have remove ssl certificate for security reasons.
+  So default https server won't run.
+  In order to make it work as before you need to specify two things
   1. install `@zohodesk-private/client_dev_cert`
-  2.  `react-cli.app.server.httpsCerts` option example `"httpsCerts": "@zohodesk-private/client_dev_cert"`
-  unless configaration are proper this may break `start` , `docs` , `nowatchstart`. and mock wms `/wmsmockapi` won't work.
-  So Please be carefull when you update this version or above without proper configaration.
-
+  2. `react-cli.app.server.httpsCerts` option example `"httpsCerts": "@zohodesk-private/client_dev_cert"`
+     unless configaration are proper this may break `start` , `docs` , `nowatchstart`. and mock wms `/wmsmockapi` won't work.
+     So Please be carefull when you update this version or above without proper configaration.
 
 # 0.0.1-beta.178
 
@@ -118,13 +523,13 @@ For more info please refer to :
 
 **Breaking Changes:**
 
-- We have remove ssl certificate for security reasons.  
-  So default https server won't run.  
-  In order to make it work as before you  need to specify two things
+- We have remove ssl certificate for security reasons.
+  So default https server won't run.
+  In order to make it work as before you need to specify two things
   1. install `@zohodesk-private/client_dev_cert`
-  2.  `react-cli.app.server.httpsCerts` option example `"httpsCerts": "@zohodesk-private/client_dev_cert"`
-  unless configaration are proper this may break `start` , `docs` , `nowatchstart`.
-  So Please be carefull when you update this version or above without proper configaration.
+  2. `react-cli.app.server.httpsCerts` option example `"httpsCerts": "@zohodesk-private/client_dev_cert"`
+     unless configaration are proper this may break `start` , `docs` , `nowatchstart`.
+     So Please be carefull when you update this version or above without proper configaration.
 
 # 0.0.1-exp.178.2
 
@@ -136,13 +541,13 @@ For more info please refer to :
 
 **Breaking Changes:**
 
-- We have remove ssl certificate for security reasons.  
-  So default https server won't run.  
-  In order to make it work as before you  need to specify two things
+- We have remove ssl certificate for security reasons.
+  So default https server won't run.
+  In order to make it work as before you need to specify two things
   1. install `@zohodesk-private/client_dev_cert`
-  2.  `react-cli.app.server.httpsCerts` option example `"httpsCerts": "@zohodesk-private/client_dev_cert"`
-  unless configaration are proper this may break `start` , `docs` , `nowatchstart`.
-  So Please be carefull when you update this version or above without proper configaration.
+  2. `react-cli.app.server.httpsCerts` option example `"httpsCerts": "@zohodesk-private/client_dev_cert"`
+     unless configaration are proper this may break `start` , `docs` , `nowatchstart`.
+     So Please be carefull when you update this version or above without proper configaration.
 
 # 0.0.1-beta.177
 
@@ -203,8 +608,8 @@ cli has been updated to fix compose issue faced when classname:hover exists and
 
 **Feature:-**
 
-- `react-cli.test.classnameFormat` option added to change CssModules (Ex: import style from "./a.module.css" ) className transform template unittest case.  
-   `classnameFormat` default value `[classname]` you can customize it. Example: `[classname]-[hash]`
+- `react-cli.test.classnameFormat` option added to change CssModules (Ex: import style from "./a.module.css" ) className transform template unittest case.
+  `classnameFormat` default value `[classname]` you can customize it. Example: `[classname]-[hash]`
 
 **Changes:-**
 
@@ -223,7 +628,7 @@ For an more information and reference, refer to `[details](https://zgit.csez.zoh
 
 # 0.0.1-beta.172
 
-We have renamed some options, For Our future features convenience.  
+We have renamed some options, For Our future features convenience.
 We have given fallback support.
 Deprecation Warnings:-
 
@@ -300,8 +705,9 @@ Features:-
 - In docs we have added `Description` for Component Props- check out it in `PropTypes` tab
 
 # 0.0.1-beta.167.1
-In this version we merged changes from [0.0.1-betaa.138.1](#0.0.1-betaa.138.1).  
-and with [0.0.1-beta.167](#0.0.1-beta.167) version changes.  
+
+In this version we merged changes from [0.0.1-betaa.138.1](#0.0.1-betaa.138.1).
+and with [0.0.1-beta.167](#0.0.1-beta.167) version changes.
 
 # 0.0.1-beta.167
 
@@ -565,6 +971,7 @@ impact servise related changes:-
 - few enhancements
 
 # 0.0.1-betaa.138.1
+
 - new feature added for custom extra attribute for dynamically added tags by webpack.
 - To enable this feature you need to enable "react-cli" => "app" => "customAttributes" => "enable"
 - For more [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/9eea8df14e55584b2114b5e484ca8b751a4ba191/src/plugins/CustomAttributePlugin.md)
@@ -1207,3 +1614,7 @@ impact servise related changes:-
 - prod string error fix
 - efc build support
 - single style tag support
+
+```
+
+```