@zohodesk/react-cli 0.0.1-test.148.2 → 1.0.0

package/docs/CustomChunks.md

@@ -0,0 +1,26 @@
+# Custom Chunks
+
+In react-cli we provide options to create custom chunks.  
+This Custom Chunk Option is array of Object
+that Object keys are
+
+- `pattern` regex pattern as string
+- `name` chunk name
+- `size` is count which is minmum chunk dublicated or need in chunks
+
+> Since 0.0.1-exp.164.1
+
+extra features in custom chunks :-
+for more details [SplitChunkPlugin](https://webpack.js.org/plugins/split-chunks-plugin/) webpack
+
+- `minChunks`: `minChunks` is alies of `size` default value is `2`,
+- `rules`: `rules` is same as `pattern` with some easy hooks
+  - use `/` for both windows and linux we will replace internally
+  - for `.*` we need to use `*`
+  - we can consider rules as regex when the `rules-string` has any of these `*`, `^`, `$`. So if you want regex then kindly use `*` in your `rules-string` for force regex
+- `chunks`: by this option we can specify , default value is `all`,
+- `priority`: priority default value is `-10 * (index + 2)`,
+- `enforce`: enforce default value is true,
+- `maxSize`: maxSize, default value is 0,
+- `minSize`: minSize, default value is 20000,
+  includeDepenency: includeDepenency default value is false

package/docs/DevServerPort.md

@@ -0,0 +1,39 @@
+# Dev server port
+
+in react-cli dev server ports are below
+
+In summary 
+for https port will be same as given
+for http2 port will be same as given + 1
+for http  port will be same as given + 2 
+
+with https certificate `react-cli.app.sercer.httpsCerts` given value
+in default port `react-cli.app.server.port` is 9090
+
+| Protocal | Port |
+| :------: | :--: |
+|  HTTPS   | 9090 |
+|  HTTP2   | 9091 |
+|   HTTP   | 9092 |
+
+in custom port `react-cli.app.server.port` is 5050
+
+| Protocal | Port |
+| :------: | :--: |
+|  HTTPS   | 5050 |
+|  HTTP2   | 5051 |
+|   HTTP   | 5052 |
+
+with out https certificate 
+
+in custom port `react-cli.app.server.port` is 9090
+
+| Protocal | Port |
+| :------: | :--: |
+|   HTTP   | 9092 |
+
+in custom port `react-cli.app.server.port` is 5050
+
+| Protocal | Port |
+| :------: | :--: |
+|   HTTP   | 5052 |

package/docs/DevStart.md

@@ -0,0 +1,18 @@
+# DevServer Start
+
+## command
+
+> `react-cli start`
+
+## Options
+
+we have to typs of options command line arguments and package.json option specifying
+
+### First package.json option specifying
+
+1. `react-cli.app.context`
+1. `react-cli.app.server`
+1. `react-cli.app.server`
+1. `react-cli.app.server`
+1. `react-cli.app.server`
+1. `react-cli.app.server`

package/docs/HoverActive.md

@@ -0,0 +1,12 @@
+# hover active css handling
+
+In general we write css with some hover in it.  
+But In mobile there is no hover and some times this hover css may do something messy some thing like we may need to click a button we need to click it double time.
+
+To handle this behaviour we write a postcss plugin
+
+PostCSS plugin that transforms :hover selectors to :active on devices where a mouse isn't the primary input mechanism.
+
+when we write hover css it will have some problem in mobile devices the reason was in mobile device ther is no mouse
+
+for this we have to handle that as

package/docs/InstallNode.md

@@ -0,0 +1,28 @@
+### Step 1: Update APT index
+
+Run the apt update command on your Ubuntu Linux to update package repository contents database.
+
+> sudo apt update
+
+### Step 2: Install Node.js 14 on Ubuntu 22.04|20.04|18.04
+
+After system update, install Node.js 14 on Ubuntu 22.04|20.04|18.04 by first installing the required repository.
+
+> curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -
+
+The script above will create apt sources list file for the NodeSource Node.js 14.x repo:
+
+> \# Ubuntu 20.04 example
+>
+> $ cat /etc/apt/sources.list.d/nodesource.list
+> deb https://deb.nodesource.com/node_14.x focal main
+> deb-src https://deb.nodesource.com/node_14.x focal main
+
+Once the repository is added, you can begin the installation of Node.js 14 on Ubuntu Linux:
+
+> sudo apt -y install nodejs
+
+Verify the version of Node.js installed.
+
+> $ node -v  
+> v14.17.5

package/docs/SelectorWeight.md

@@ -0,0 +1,6 @@
+
+-- Selector weight plugin --
+ * Plugin implementation for the execution of a Selector weight to be added to all classes of multiple files is included in the react-cli setup. This can be activated when the `selectorWeight` variable in `package.json` is set to true.
+ * all classes in all files will be added with the `defaultSelector` provided in package.json to increase selector weight
+ * in case a specific chunk file is supposed to have a different selector, it can be mentioned in the `customFileSelectorWeight.json`. This will add the new selector to that particular chunk file.
+ * `excludeStrings` is an array used to exclude selectors that should not be converted. Default selectors such as body, html are excluded through this way.

package/docs/TODOS.md

@@ -0,0 +1,10 @@
+we need to fix all the warning print while install react-cli
+
+1.  npm WARN deprecated `babel-eslint@10.1.0`: babel-eslint is now `@babel/eslint-parser`. This package will no longer receive updates.
+    to resolve this warning use https://tjaddison.com/blog/2021/03/updating-babel-eslint-to-babeleslint-parser-for-react-apps/
+
+2.  npm WARN deprecated eslint-loader@4.0.2: This loader has been deprecated. Please use eslint-webpack-plugin.  
+    for this warning we need to confirm `is eslint-loader need while build` it's simplely waste of time if you ask me.
+3.  gitlab@14.2.2: The gitlab package has found a new home in the @gitbeaker organization. For the latest gitlab node library, check out @gitbeaker/node
+    for this warning we need to check with gitbeaker and impact team as well.
+4.  `fsevents@1.2.13` and `chokidar@2.1.8` these are just dependent packages need to check parent package of this package

package/docs/ValueReplacer.md

@@ -0,0 +1,60 @@
+# value replacer
+
+<!-- file paths
+  1. src/postcss-plugins/ValueReplacer.js
+  2. src/common/valueReplacer.js
+ -->
+
+this option is array of objects which will have a two keys
+new option `valueReplacer` added for replace css property value while build running
+
+- this option is array of object, that object two keys
+  1. `props` key for array of property names
+  2. `values` key is object ,this object key contents will be replaced as value content
+- this option wiil be work for below
+
+  - `start`
+  - `docs`
+  - `nowatchstart`
+  - `devbuild`
+  - `build:library:es`
+  - `build:component:es`
+  - `build:library:cmjs`
+  - `build:component:cmjs`
+    Example data:-
+
+  ```json
+  {
+    "react-cli": {
+      "css": {
+        "valueReplacer": [
+          {
+            "props": ["font", "font-family"],
+            "values": {
+              "zdfonts-rCallBar": "zdf-rCallBar_1",
+              "zdfonts-rPuvi": "zdf-rPuvi_1"
+            }
+            // ,suffix: '0'
+          }
+        ]
+      }
+    }
+  }
+  ```
+
+  Example Replace:-
+  before replace
+
+  ```css
+  .some-selector {
+    font: zdfonts-rCallBar !important;
+  }
+  ```
+
+  after replace
+
+  ```css
+  .some-selector {
+    font: zdf-rCallBar_1 !important;
+  }
+  ```