@zohodesk/client_build_tool 0.0.11-exp.16 → 0.0.11-exp.16.0

package/README.md

@@ -113,210 +113,6 @@ fixes :-
 
 
 
-# v0.0.11
-
-# v0.0.10 (12-05-2025)
-**Feature:-**
-- `alias` support for `build:es` and `build:lib`
-    - Add babel-plugin-module-resolver dependencies
-    - Modify getBabelPlugin to include module resolver with aliases
-
-**Bug Fix:-**
-- Enhance runBabelForTSFile to handle both .tsx and .ts file extensions
-- Update mockApiHandler to ensure mock function is called correctly
-
-**Change:-**
-- Refactor defaultConfigValues.js to include cli options for enableRTLSplit
-
-## v0.0.9 
-
-**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>
-   }
-```
-
-## v0.0.6 (4-09-2023)
-
-**Feature:-**
-- Generating bundle integrity report 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 efc flag resourcecleanup flag.
-- 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 glob pattern for custom chunks split logic.
-- added options to split chunks base config in the key `app` => `customChunksBaseConfig` as object
-
-**Change:-**
-- i18n name not generated issue fix.
-- public path not correctly set issue fix.
-- changing plugin hook stages in i18nRuntimePlugin and sourceMapPlugin
-## v0.0.5 (6-08-2023)
-
-**Changes:--**
-- Typo fix in i18nRuntimeDealerPlugin.js
-- fixing some bugs in resolvers.js file
-
-## v0.0.3 (1-08-2023)
-
-**Changes:--**
-- `devtool` default value changed from `hidden-cheap-source-map` to `source-map`
-- unwanted files deleted from build
-
-**Issue Fix:--**
-- The issue with the source map not being created in the build has been fixed."
-
-
-## v0.0.2 (28-04-2023)
-
-**Features:-**
-
-- `devModeContentHashAllowedTypes` support added for some project there will be a need for hash even though they run dev mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devModeContentHashAllowedTypes)
-- `devLikeHash` support for disable content hash for file names in production mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devLikeHash)
-- `disableReactDevWarning` disable react dev warning such as prop-type warnings will be removed in dev mode build or server. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#disableReactDevWarning) can be enabled via `--disable_react_dev_warning` too.
-- `statsLogConfig` support to customize default webpack log after build finished. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#statsLogConfig) can be enabled via `--disable_react_dev_warning` too.
-- `enableChunkHash` renamed as `enableFileNameHashing`
-
-- `pre_processor` command to run the preprocessor.js file.preProcessor runs in build, start, buildEs, buildLib commands bu default. and we have watch mode support as well with the option (`-w`)
-- `createSeparateSmap` flag `source_map_enable` renamed as `enable_smap`
-- `removeAttribute` option changes as `babelCustomizations.removeAttribute`
-- `removePropTypes` support for remove the prop types package in the output build.
-- `devConsoleExclude` support for remove the _console statements_ such as _console.log_, _console.warn_ in the output build.
-- `manifestJson` default value set as false.
-- `customAttributes` support for add attributes to html, link , script tag in the output build.
-
-
-## v0.0.1 (18-04-2023)
-
-First Release
-**Features:-**
-
-- 'start' command to run react app
-- 'build' command to create build for react app
-- 'build:lib' command to create lib for react library
-- 'build:es' command to create es for react library
-- 'templates' command to create es for react library
-# Changelog and Release Notes
-
-- remove babel-plugin-module-resolver dependencies
-
-**Adjustments:-**
- - Public Folder configuration is separated for development and production
-
-**Bug Fix:-**
-- Fixed the issue where the build log was not visible when `stats (bundle integrity)` was enabled. The problem was resolved by adding an error check in the `bundleIntegrity plugin`.
-- Removed the babel-plugin-module-resolver dependency to resolve the alias resolution issue in the application.
-- Fixed the issue where a space in the variable name causes it to return an undefined value.
-- Fixed the URL path generation issue that occurred while using context in the development setup.
-
-
-
-# v0.0.11
-
-# v0.0.10 (12-05-2025)
-**Feature:-**
-- `alias` support for `build:es` and `build:lib`
-    - Add babel-plugin-module-resolver dependencies
-    - Modify getBabelPlugin to include module resolver with aliases
-
-**Bug Fix:-**
-- Enhance runBabelForTSFile to handle both .tsx and .ts file extensions
-- Update mockApiHandler to ensure mock function is called correctly
-
-**Change:-**
-- Refactor defaultConfigValues.js to include cli options for enableRTLSplit
-
-## v0.0.9 
-
-**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>
-   }
-```
-
-## v0.0.6 (4-09-2023)
-
-**Feature:-**
-- Generating bundle integrity report 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 efc flag resourcecleanup flag.
-- 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 glob pattern for custom chunks split logic.
-- added options to split chunks base config in the key `app` => `customChunksBaseConfig` as object
-
-**Change:-**
-- i18n name not generated issue fix.
-- public path not correctly set issue fix.
-- changing plugin hook stages in i18nRuntimePlugin and sourceMapPlugin
-## v0.0.5 (6-08-2023)
-
-**Changes:--**
-- Typo fix in i18nRuntimeDealerPlugin.js
-- fixing some bugs in resolvers.js file
-
-## v0.0.3 (1-08-2023)
-
-**Changes:--**
-- `devtool` default value changed from `hidden-cheap-source-map` to `source-map`
-- unwanted files deleted from build
-
-**Issue Fix:--**
-- The issue with the source map not being created in the build has been fixed."
-
-
-## v0.0.2 (28-04-2023)
-
-**Features:-**
-
-- `devModeContentHashAllowedTypes` support added for some project there will be a need for hash even though they run dev mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devModeContentHashAllowedTypes)
-- `devLikeHash` support for disable content hash for file names in production mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devLikeHash)
-- `disableReactDevWarning` disable react dev warning such as prop-type warnings will be removed in dev mode build or server. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#disableReactDevWarning) can be enabled via `--disable_react_dev_warning` too.
-- `statsLogConfig` support to customize default webpack log after build finished. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#statsLogConfig) can be enabled via `--disable_react_dev_warning` too.
-- `enableChunkHash` renamed as `enableFileNameHashing`
-
-- `pre_processor` command to run the preprocessor.js file.preProcessor runs in build, start, buildEs, buildLib commands bu default. and we have watch mode support as well with the option (`-w`)
-- `createSeparateSmap` flag `source_map_enable` renamed as `enable_smap`
-- `removeAttribute` option changes as `babelCustomizations.removeAttribute`
-- `removePropTypes` support for remove the prop types package in the output build.
-- `devConsoleExclude` support for remove the _console statements_ such as _console.log_, _console.warn_ in the output build.
-- `manifestJson` default value set as false.
-- `customAttributes` support for add attributes to html, link , script tag in the output build.
-
-
-## v0.0.1 (18-04-2023)
-
-First Release
-**Features:-**
-
-- 'start' command to run react app
-- 'build' command to create build for react app
-- 'build:lib' command to create lib for react library
-- 'build:es' command to create es for react library
-- 'templates' command to create es for react library
-# Changelog and Release Notes
-
-- remove babel-plugin-module-resolver dependencies
-
-**Adjustments:-**
- - Public Folder configuration is separated for development and production
-
-**Bug Fix:-**
-- Fixed the issue where the build log was not visible when `stats (bundle integrity)` was enabled. The problem was resolved by adding an error check in the `bundleIntegrity plugin`.
-- Removed the babel-plugin-module-resolver dependency to resolve the alias resolution issue in the application.
-- Fixed the issue where a space in the variable name causes it to return an undefined value.
-- Fixed the URL path generation issue that occurred while using context in the development setup.
-
-
-
 # v0.0.11
 
 # v0.0.10 (12-05-2025)

package/README_backup.md

@@ -98,207 +98,3 @@ fixes :-
 
 - preload plc undefined url fixed 
 
-# Changelog and Release Notes
-
-- remove babel-plugin-module-resolver dependencies
-
-**Adjustments:-**
- - Public Folder configuration is separated for development and production
-
-**Bug Fix:-**
-- Fixed the issue where the build log was not visible when `stats (bundle integrity)` was enabled. The problem was resolved by adding an error check in the `bundleIntegrity plugin`.
-- Removed the babel-plugin-module-resolver dependency to resolve the alias resolution issue in the application.
-- Fixed the issue where a space in the variable name causes it to return an undefined value.
-- Fixed the URL path generation issue that occurred while using context in the development setup.
-
-
-
-# v0.0.11
-
-# v0.0.10 (12-05-2025)
-**Feature:-**
-- `alias` support for `build:es` and `build:lib`
-    - Add babel-plugin-module-resolver dependencies
-    - Modify getBabelPlugin to include module resolver with aliases
-
-**Bug Fix:-**
-- Enhance runBabelForTSFile to handle both .tsx and .ts file extensions
-- Update mockApiHandler to ensure mock function is called correctly
-
-**Change:-**
-- Refactor defaultConfigValues.js to include cli options for enableRTLSplit
-
-## v0.0.9 
-
-**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>
-   }
-```
-
-## v0.0.6 (4-09-2023)
-
-**Feature:-**
-- Generating bundle integrity report 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 efc flag resourcecleanup flag.
-- 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 glob pattern for custom chunks split logic.
-- added options to split chunks base config in the key `app` => `customChunksBaseConfig` as object
-
-**Change:-**
-- i18n name not generated issue fix.
-- public path not correctly set issue fix.
-- changing plugin hook stages in i18nRuntimePlugin and sourceMapPlugin
-## v0.0.5 (6-08-2023)
-
-**Changes:--**
-- Typo fix in i18nRuntimeDealerPlugin.js
-- fixing some bugs in resolvers.js file
-
-## v0.0.3 (1-08-2023)
-
-**Changes:--**
-- `devtool` default value changed from `hidden-cheap-source-map` to `source-map`
-- unwanted files deleted from build
-
-**Issue Fix:--**
-- The issue with the source map not being created in the build has been fixed."
-
-
-## v0.0.2 (28-04-2023)
-
-**Features:-**
-
-- `devModeContentHashAllowedTypes` support added for some project there will be a need for hash even though they run dev mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devModeContentHashAllowedTypes)
-- `devLikeHash` support for disable content hash for file names in production mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devLikeHash)
-- `disableReactDevWarning` disable react dev warning such as prop-type warnings will be removed in dev mode build or server. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#disableReactDevWarning) can be enabled via `--disable_react_dev_warning` too.
-- `statsLogConfig` support to customize default webpack log after build finished. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#statsLogConfig) can be enabled via `--disable_react_dev_warning` too.
-- `enableChunkHash` renamed as `enableFileNameHashing`
-
-- `pre_processor` command to run the preprocessor.js file.preProcessor runs in build, start, buildEs, buildLib commands bu default. and we have watch mode support as well with the option (`-w`)
-- `createSeparateSmap` flag `source_map_enable` renamed as `enable_smap`
-- `removeAttribute` option changes as `babelCustomizations.removeAttribute`
-- `removePropTypes` support for remove the prop types package in the output build.
-- `devConsoleExclude` support for remove the _console statements_ such as _console.log_, _console.warn_ in the output build.
-- `manifestJson` default value set as false.
-- `customAttributes` support for add attributes to html, link , script tag in the output build.
-
-
-## v0.0.1 (18-04-2023)
-
-First Release
-**Features:-**
-
-- 'start' command to run react app
-- 'build' command to create build for react app
-- 'build:lib' command to create lib for react library
-- 'build:es' command to create es for react library
-- 'templates' command to create es for react library
-# Changelog and Release Notes
-
-- remove babel-plugin-module-resolver dependencies
-
-**Adjustments:-**
- - Public Folder configuration is separated for development and production
-
-**Bug Fix:-**
-- Fixed the issue where the build log was not visible when `stats (bundle integrity)` was enabled. The problem was resolved by adding an error check in the `bundleIntegrity plugin`.
-- Removed the babel-plugin-module-resolver dependency to resolve the alias resolution issue in the application.
-- Fixed the issue where a space in the variable name causes it to return an undefined value.
-- Fixed the URL path generation issue that occurred while using context in the development setup.
-
-
-
-# v0.0.11
-
-# v0.0.10 (12-05-2025)
-**Feature:-**
-- `alias` support for `build:es` and `build:lib`
-    - Add babel-plugin-module-resolver dependencies
-    - Modify getBabelPlugin to include module resolver with aliases
-
-**Bug Fix:-**
-- Enhance runBabelForTSFile to handle both .tsx and .ts file extensions
-- Update mockApiHandler to ensure mock function is called correctly
-
-**Change:-**
-- Refactor defaultConfigValues.js to include cli options for enableRTLSplit
-
-## v0.0.9 
-
-**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>
-   }
-```
-
-## v0.0.6 (4-09-2023)
-
-**Feature:-**
-- Generating bundle integrity report 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 efc flag resourcecleanup flag.
-- 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 glob pattern for custom chunks split logic.
-- added options to split chunks base config in the key `app` => `customChunksBaseConfig` as object
-
-**Change:-**
-- i18n name not generated issue fix.
-- public path not correctly set issue fix.
-- changing plugin hook stages in i18nRuntimePlugin and sourceMapPlugin
-## v0.0.5 (6-08-2023)
-
-**Changes:--**
-- Typo fix in i18nRuntimeDealerPlugin.js
-- fixing some bugs in resolvers.js file
-
-## v0.0.3 (1-08-2023)
-
-**Changes:--**
-- `devtool` default value changed from `hidden-cheap-source-map` to `source-map`
-- unwanted files deleted from build
-
-**Issue Fix:--**
-- The issue with the source map not being created in the build has been fixed."
-
-
-## v0.0.2 (28-04-2023)
-
-**Features:-**
-
-- `devModeContentHashAllowedTypes` support added for some project there will be a need for hash even though they run dev mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devModeContentHashAllowedTypes)
-- `devLikeHash` support for disable content hash for file names in production mode. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#devLikeHash)
-- `disableReactDevWarning` disable react dev warning such as prop-type warnings will be removed in dev mode build or server. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#disableReactDevWarning) can be enabled via `--disable_react_dev_warning` too.
-- `statsLogConfig` support to customize default webpack log after build finished. for details [details](https://zgit.csez.zohocorpin.com/zohodesk/react-cli/-/blob/3.0.0/packages/client_build_tool/ConfigurationDocumentation.md#statsLogConfig) can be enabled via `--disable_react_dev_warning` too.
-- `enableChunkHash` renamed as `enableFileNameHashing`
-
-- `pre_processor` command to run the preprocessor.js file.preProcessor runs in build, start, buildEs, buildLib commands bu default. and we have watch mode support as well with the option (`-w`)
-- `createSeparateSmap` flag `source_map_enable` renamed as `enable_smap`
-- `removeAttribute` option changes as `babelCustomizations.removeAttribute`
-- `removePropTypes` support for remove the prop types package in the output build.
-- `devConsoleExclude` support for remove the _console statements_ such as _console.log_, _console.warn_ in the output build.
-- `manifestJson` default value set as false.
-- `customAttributes` support for add attributes to html, link , script tag in the output build.
-
-
-## v0.0.1 (18-04-2023)
-
-First Release
-**Features:-**
-
-- 'start' command to run react app
-- 'build' command to create build for react app
-- 'build:lib' command to create lib for react library
-- 'build:es' command to create es for react library
-- 'templates' command to create es for react library

package/docs/DYNAMIC_TEMPLATE_EXAMPLE.md

@@ -0,0 +1,129 @@
+# Dynamic singleFileTemplate Configuration
+
+## Overview
+The `singleFileTemplate` option now supports both static strings and dynamic functions, allowing different filename patterns based on build mode.
+
+## Configuration Options
+
+### 1. Static Template (Simple)
+```javascript
+i18nIndexing: {
+  singleFileTemplate: '[locale].js'  // Always uses this format
+}
+```
+
+### 2. Dynamic Template with Function
+```javascript
+i18nIndexing: {
+  isDevelopment: isDevelopment,  // Pass from your app
+  singleFileTemplate: (isDev) => 
+    isDev ? '[locale].js' : '[locale].[contenthash].js'
+}
+```
+
+### 3. Inline Conditional (Pre-resolved)
+```javascript
+i18nIndexing: {
+  isDevelopment: isDevelopment,  // Pass from your app
+  singleFileTemplate: isDevelopment 
+    ? '[locale].js' 
+    : '[locale].[contenthash].js'
+}
+```
+
+## Template Placeholders
+
+- `[locale]` - Replaced with actual locale code (e.g., en_US, fr_FR)
+- `[contenthash]` - Replaced with content-based hash for cache busting
+
+## Output Examples
+
+### Development Mode (isDevelopment = true)
+```
+Template: '[locale].js'
+Output:
+  i18n/en_US.js
+  i18n/fr_FR.js
+  i18n/de_DE.js
+```
+
+### Production Mode (isDevelopment = false)
+```
+Template: '[locale].[contenthash].js'
+Output:
+  i18n/en_US.b9ef890a.js
+  i18n/fr_FR.3452451e.js
+  i18n/de_DE.e8b84364.js
+```
+
+## Complete Example Configuration
+
+```javascript
+exports.config = {
+  context: 'src',
+  output: 'build',
+  mode: process.env.NODE_ENV || 'production',
+  
+  // Pass isDevelopment from your app
+  isDevelopment: process.env.NODE_ENV === 'development',
+  
+  i18nIndexing: {
+    enable: true,
+    outputFolder: 'i18n',
+    jsResourcePath: './resources/ApplicationResources.properties',
+    propertiesFolderPath: './resources',
+    numericMapPath: './numericMap.json',
+    
+    // Dynamic template based on build mode
+    singleFileTemplate: function(isDevelopment) {
+      return isDevelopment ? '[locale].js' : '[locale].[contenthash].js';
+    },
+    
+    // Or using arrow function
+    // singleFileTemplate: (isDev) => isDev ? '[locale].js' : '[locale].[contenthash].js',
+    
+    // Or pre-resolved
+    // singleFileTemplate: isDevelopment ? '[locale].js' : '[locale].[contenthash].js',
+    
+    singleFile: true,
+    jsonpFunc: 'var imAppI18n=',
+    htmlTemplateLabel: '{{--user-locale}}',
+    localeVarName: 'window.userLangCode',
+    generateManifest: true,
+    manifestPath: 'i18n/manifest.json'
+    
+    // Note: includeContentHash is now optional when using [contenthash] in template
+    // includeContentHash: true  // Not needed with [contenthash] placeholder
+  }
+};
+```
+
+## Benefits
+
+1. **Development**: Clean, readable filenames without hashes for easier debugging
+2. **Production**: Content-hashed filenames for optimal caching
+3. **Flexibility**: Single configuration handles both environments
+4. **No Redundancy**: Using `[contenthash]` in template eliminates need for `includeContentHash` option
+
+## Migration from includeContentHash
+
+### Old Way
+```javascript
+singleFileTemplate: '[locale].js',
+includeContentHash: true  // Adds hash before .js
+// Output: en_US.abc123.js
+```
+
+### New Way (Recommended)
+```javascript
+singleFileTemplate: isDevelopment ? '[locale].js' : '[locale].[contenthash].js'
+// Output: en_US.abc123.js (production) or en_US.js (development)
+```
+
+## Notes
+
+- The function receives `isDevelopment` as a boolean parameter
+- You must pass `isDevelopment` in your main options object
+- The `[contenthash]` placeholder is automatically replaced with the actual hash
+- For HTML injection, the hash placeholder is removed since the exact hash isn't known at HTML generation time
+- The manifest will map clean names to hashed versions for deployment scripts