@zohodesk/react-cli 1.1.17 → 1.1.18-exp.1

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/I18nSplit.md

@@ -0,0 +1,95 @@
+# I18n Split As Chunks Plugin
+
+generaly we have manage our all I18n keys and values as language specific i18n files and then we download all i18n in initial page load.
+
+### what is the problem with this?.
+
+the problem is i18n file keep get's grown it will affect the the inital page load and critial rendering path.
+So, We have decide to create a plugin for split i18n per chunk's of js vise.
+
+### what is i18n split?
+
+it is like code split for i18n.
+we will collect i18n from js chunk and we will create separate i18n chunk per js chunk,  
+ with this we already load Js chunks are on demand and now we also download i18n also ondemand with this the initial and forthere actions.  
+ when js download's we will download i18n with it.
+
+### How to we going to i18n split?
+
+we will read the js chunk and collect I18n keys form it,  
+ then we will create i18n chunk files with these used keys.
+
+### how do you collect i18n keys from js files?
+
+we will traverse the js file's AST (static analysis) and find i18 keys,  
+ we will concider all string which is in jsResource file as i18n keys.  
+ and you can tell dynamic i18n key by js comments,  
+ Like Below:-
+
+```js
+fetch('tickets?view=view1').then(data => {
+  // I18n support.ticketsEmpty
+  // I18n support.viewNotFount
+  // I18n support.permissionDenied
+  let text = getI18nValue(data.i18nkey);
+});
+```
+
+### is there any posiblity for unwanted keys in some chunk?
+
+Yes, there is two posiblity
+
+1. js comment , if you write js comment but it is not needed then it will be add into i18n chunk  
+   `To Resolve` we currently do not have perfect idea for this, But we can check this by chunk size limit.  
+   `idea's will be welcome`
+2. like we said "we will concider all string which is in jsResource file as i18n keys",  
+   So if you use string not for i18n but it was in jsResource then it will be add into i18n chunk.  
+   `To Resolve` this problem we can use some kinda prefix or something.
+
+### how do we downlowd and give to app?
+
+we have over write defualt webpack requireEnsure (every dynamic chunk requests are done by that function) function.  
+ and we parlarly dowload i18n files. and we ask jsonFunction, to our plugin.  
+So we send i18nkeys , when it was download,  
+you must store all i18n keys, we give asycrnsly by that function download in that patticular.  
+so you must store and update (like append or assign) everytime that function call.
+
+### how to use this feature?
+
+to use this feature use have give the below oprtions  
+ `package.json`
+
+```json
+{
+  /// ...some things
+  "react-cli": {
+    //  ...some things
+    "i18n": {
+      "chunkSplitEnable": true,
+      "jsResource": "./deskapp/properties/JSResources.properties",
+      "localeVarName": "window.userInfo.langCode",
+      "jsonpFunc": "window.loadI18nChunk",
+      "templateLabel": "{{--user-locale}}", // this is  for html template i18n file path locate template
+      "propertiesFolder": "./deskapp/properties"
+    }
+    //  ...some things
+  }
+}
+```
+
+<!-- not need below -->
+<!--we have added new feature for css to write logic to how hover related css work in hoverhover and a
+
+### is there any problems with static analysis?
+  Yes,
+
+### how do we use dynamic i18n key?
+
+  and we will download i18n file with
+
+  and when js chunk download's then we will download i18n as need.
+  we all know in our app we loading i18n as one single big file for each locale(language).
+  we are going to split i18n as per js chunk, and when js chunk download's then we will download i18n as need.
+
+
+  -->

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/README.md

@@ -0,0 +1,25 @@
+# I18n Split As Chunks Plugin
+
+generaly we have manage our all I18n keys and values as language specific i18n files and then we download all i18n in initial page load.
+
+Ok, what is the problem with this?.
+the problem is i18n file keep get's grown it will affect the the inital page load and critial rendering path.
+So, We have decide to create a plugin for split i18n per chunk's of js vise, Which mean we diside to create for each js chunk has its own i18n chunks, with this we already load Js chunks are on demand and now we also download i18n also ondemand with this the initial and forthere actions.
+
+Ok, How to you do this thing?
+we have read the js chunk and collect I18n keys what are used in that chunk and we will create i18n chunk files with only used key.
+
+Ok, How do you collect that keys?
+we now have two experimental stage to collect I18n keys.
+
+1. we read jsResource.properties (or all keys I18n file) then we walk this AST of js and we collect all string which is jsResource.properties.
+2. for dynamic we discide to use comment some thing like
+   `// I18n support.tickekt.email.notvalid`
+
+ok, how do you downlowd and give to app?
+we have over write defualt webpack require ensure function.
+So every dynamic chunk requset are done by that function.
+So we parlarly dowload i18n files. and we ask jsonFunction, to our plugin.
+So we send i18nkeys , when it was download,
+you must store all i18n keys, we give asycrnsly by that function download in that patticular.
+so you must store and update (like append or assign) everytime that function call.

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/constants.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TYPES = exports.SINGLE_DOT_PATH_SEGMENT = exports.MODULE_TYPE = exports.I18N_CHUNK_NAME_GENERATION_SEGMENT = exports.DEFAULT_FILENAME = exports.DEFAULT_CHUNK_FILENAME = exports.CODE_GENERATION_RESULT = exports.BASE_URI = exports.AUTO_PUBLIC_PATH = exports.ABSOLUTE_PUBLIC_PATH = void 0;
+const MODULE_TYPE = 'i18n/mini-extract';
+exports.MODULE_TYPE = MODULE_TYPE;
+const AUTO_PUBLIC_PATH = '__mini_i18n_extract_plugin_public_path_auto__';
+exports.AUTO_PUBLIC_PATH = AUTO_PUBLIC_PATH;
+const ABSOLUTE_PUBLIC_PATH = 'webpack:///mini-i18n-extract-plugin/';
+exports.ABSOLUTE_PUBLIC_PATH = ABSOLUTE_PUBLIC_PATH;
+const BASE_URI = 'webpack://';
+exports.BASE_URI = BASE_URI;
+const SINGLE_DOT_PATH_SEGMENT = '__mini_i18n_extract_plugin_single_dot_path_segment__';
+exports.SINGLE_DOT_PATH_SEGMENT = SINGLE_DOT_PATH_SEGMENT;
+const I18N_CHUNK_NAME_GENERATION_SEGMENT = '__mini_i18n_extract_plugin_i18n_chunk_name_generation_segment__';
+exports.I18N_CHUNK_NAME_GENERATION_SEGMENT = I18N_CHUNK_NAME_GENERATION_SEGMENT;
+const DEFAULT_FILENAME = 'i18n-chunks/[locale]/[name].[contenthash].i18n.js';
+exports.DEFAULT_FILENAME = DEFAULT_FILENAME;
+const DEFAULT_CHUNK_FILENAME = 'i18n-chunks/[locale]/[id].[contenthash].i18n.js';
+exports.DEFAULT_CHUNK_FILENAME = DEFAULT_CHUNK_FILENAME;
+const TYPES = new Set([MODULE_TYPE]);
+exports.TYPES = TYPES;
+const CODE_GENERATION_RESULT = {
+  sources: new Map(),
+  runtimeRequirements: new Set()
+};
+exports.CODE_GENERATION_RESULT = CODE_GENERATION_RESULT;

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/createHash.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createHash = createHash;
+
+function createHash({
+  compiler,
+  outputOptions,
+  content
+}) {
+  const {
+    hashFunction,
+    hashDigest,
+    hashDigestLength
+  } = outputOptions;
+  const {
+    createHash
+  } = compiler.webpack.util;
+  const hash = createHash(hashFunction);
+  hash.update(content);
+  return hash.digest(hashDigest).substring(0, hashDigestLength);
+}

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/getI18nDependency.js

@@ -0,0 +1,99 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getI18nDependency = getI18nDependency;
+exports.i18nDependencyCache = void 0;
+
+var _path = _interopRequireDefault(require("path"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/* eslint-disable class-methods-use-this */
+const i18nDependencyCache = new WeakMap();
+exports.i18nDependencyCache = i18nDependencyCache;
+
+function getI18nDependency(webpack) {
+  if (i18nDependencyCache.has(webpack)) {
+    return i18nDependencyCache.get(webpack);
+  }
+
+  class I18nDependency extends webpack.Dependency {
+    constructor({
+      identifier,
+      content
+    }, context, identifierIndex) {
+      super();
+      this.identifier = identifier;
+      this.identifierIndex = identifierIndex;
+      this.content = content; // ## this.layer = layer;
+      // ## this.supports = supports;
+      // ## this.media = media;
+      // ## this.sourceMap = sourceMap;
+
+      this.context = context;
+      this.assets = undefined;
+      this.assetsInfo = undefined;
+    }
+
+    getResourceIdentifier() {
+      return `i18n-module-${this.identifier}-${this.identifierIndex}`;
+    }
+
+    getModuleEvaluationSideEffectsState() {
+      return webpack.ModuleGraphConnection.TRANSITIVE_ONLY;
+    }
+
+    serialize(context) {
+      const {
+        write
+      } = context;
+      write(this.identifier);
+      write(this.content); // ## write(this.layer);
+      // ## write(this.supports);
+      // ## write(this.media);
+      // ## write(this.sourceMap);
+
+      write(this.context);
+      write(this.identifierIndex);
+      write(this.assets);
+      write(this.assetsInfo);
+      super.serialize(context);
+    }
+
+    deserialize(context) {
+      super.deserialize(context);
+    }
+
+  }
+
+  i18nDependencyCache.set(webpack, I18nDependency);
+  webpack.util.serialization.register(I18nDependency, _path.default.resolve(__dirname, 'I18nDependency-new'), null, {
+    serialize(instance, context) {
+      instance.serialize(context);
+    },
+
+    deserialize(context) {
+      const {
+        read
+      } = context;
+      const dep = new I18nDependency({
+        identifier: read(),
+        content: read() // ## layer: read(),
+        // ## supports: read(),
+        // ## media: read(),
+        // ## sourceMap: read()
+
+      }, read(), read());
+      const assets = read();
+      const assetsInfo = read();
+      dep.assets = assets;
+      dep.assetsInfo = assetsInfo;
+      dep.deserialize(context);
+      return dep;
+    }
+
+  });
+  return I18nDependency;
+}

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/getI18nLoadingRuntimeModule.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getI18nLoadingRuntimeModule = getI18nLoadingRuntimeModule;
+
+/* eslint-disable no-restricted-syntax */
+const getChunksMapObject = i18nChunks => {
+  const obj = {};
+
+  for (const chunk of i18nChunks) {
+    obj[chunk.id] = 1;
+  }
+
+  return obj;
+};
+
+function getI18nLoadingRuntimeModule({
+  webpack,
+  getI18nChunks
+}) {
+  const {
+    Template,
+    RuntimeGlobals,
+    RuntimeModule
+  } = webpack;
+
+  class I18nLoadingRuntimeModule extends RuntimeModule {
+    constructor(runtimeRequirements, {
+      runtimeOptions,
+      prefixFunc
+    }) {
+      super('i18n loading', 10);
+      this.runtimeRequirements = runtimeRequirements;
+      this.prefixFunc = prefixFunc;
+      this.runtimeOptions = runtimeOptions;
+    }
+
+    generate() {
+      const {
+        chunk,
+        runtimeRequirements,
+        prefixFunc,
+        compilation
+      } = this;
+      const {
+        runtimeTemplate,
+        outputOptions: {
+          crossOriginLoading
+        }
+      } = compilation; // const i18nChunks = getI18nChunks(chunk, compilation);
+      // REASON: we do it in here is in dev mode thing may change
+      // const i18nChunks = getI18nChunks(entryRuntimeChunk);
+
+      const i18nChunks = getI18nChunks(chunk);
+      const withLoading = runtimeRequirements.has(RuntimeGlobals.ensureChunkHandlers) && i18nChunks.length > 0;
+
+      if (!withLoading) {
+        return '';
+      }
+
+      const chunkMap = getChunksMapObject(i18nChunks);
+      const {
+        attributes,
+        scriptType,
+        insert: insertRoot
+      } = this.runtimeOptions;
+      const insertPlace = typeof insertRoot === 'function' ? `(${insertRoot.toString()})(scriptTag)` : Template.asString([`var target = document.querySelector("${insertRoot}");`, 'target.parentNode.insertBefore(scriptTag, target.nextSibling);']);
+      return Template.asString([`${prefixFunc(i18nChunks)}`, `var createI18nScriptTag = ${runtimeTemplate.basicFunction('chunkId, fullsrc, resolve, reject', ['var scriptTag = document.createElement("script");', attributes ? Template.asString(Object.entries(attributes).map(entry => {
+        const [key, value] = entry;
+        return `scriptTag.setAttribute(${JSON.stringify(key)}, ${JSON.stringify(value)});`;
+      })) : '', scriptType ? `scriptTag.type = ${JSON.stringify(scriptType)};` : '', `var onScriptComplete = ${runtimeTemplate.basicFunction('event', ['// avoid mem leaks.', 'scriptTag.onerror = scriptTag.onload = null;', 'if (event.type === \'load\') {', Template.indent(['resolve();']), '} else {', Template.indent(['var errorType = event && (event.type === \'load\' ? \'missing\' : event.type);', 'var realSrc = event && event.target && event.target.src || fullsrc;', 'var err = new Error("Loading I18N chunk " + chunkId + " failed.\\n(" + realSrc + ")");', 'err.code = "I18N_CHUNK_LOAD_FAILED";', 'err.type = errorType;', 'err.request = realSrc;', 'scriptTag.parentNode.removeChild(scriptTag)', 'reject(err);']), '}'])}`, 'scriptTag.onerror = scriptTag.onload = onScriptComplete;', 'scriptTag.src = fullsrc;', crossOriginLoading ? Template.asString(['if (scriptTag.src.indexOf(window.location.origin + \'/\') !== 0) {', Template.indent(`scriptTag.crossOrigin = ${JSON.stringify(crossOriginLoading)};`), '}']) : '', insertRoot && insertPlace || Template.asString(['document.head.appendChild(scriptTag);']), 'return scriptTag;'])};`, `var findI18nScriptTag = ${runtimeTemplate.basicFunction('src, fullsrc', ['var existingScriptTags = document.getElementsByTagName("script");', 'for(var i = 0; i < existingScriptTags.length; i++) {', Template.indent(['var tag = existingScriptTags[i];', 'var dataSrc = tag.getAttribute("data-src") || tag.getAttribute("src");', 'if((dataSrc === src || dataSrc === fullsrc)) return tag;']), '}', 'var existingStyleTags = document.getElementsByTagName("style");', 'for(var i = 0; i < existingStyleTags.length; i++) {', Template.indent(['var tag = existingStyleTags[i];', 'var dataSrc = tag.getAttribute("data-src");', 'if(dataSrc === src || dataSrc === fullsrc) return tag;']), '}'])};`, `var loadI18nScriptTag = ${runtimeTemplate.basicFunction('chunkId', `return new Promise(${runtimeTemplate.basicFunction('resolve, reject', [`var src = ${RuntimeGlobals.require}.miniI18nF(chunkId);`, `var fullsrc = ${RuntimeGlobals.publicPath} + src;`, 'if(findI18nScriptTag(src, fullsrc)) return resolve();', 'createI18nScriptTag(chunkId, fullsrc, resolve, reject);'])});`)}`, withLoading ? Template.asString(['// object to store loaded I18N chunks', 'var installedI18nChunks = {', Template.indent(
+      /** @type {string[]} */
+      chunk.ids.map(id => `${JSON.stringify(id)}: 0`).join(',\n')), '};', '', `${RuntimeGlobals.ensureChunkHandlers}.miniI18n = ${runtimeTemplate.basicFunction('chunkId, promises', [`var i18nChunks = ${JSON.stringify(chunkMap)};`, 'if(installedI18nChunks[chunkId]) promises.push(installedI18nChunks[chunkId]);', 'else if(installedI18nChunks[chunkId] !== 0 && i18nChunks[chunkId]) {', Template.indent([`promises.push(installedI18nChunks[chunkId] = loadI18nScriptTag(chunkId).then(${runtimeTemplate.basicFunction('', 'installedI18nChunks[chunkId] = 0;')}, ${runtimeTemplate.basicFunction('e', ['delete installedI18nChunks[chunkId];', 'throw e;'])}));`]), '}'])};`]) : '// no chunk loading', '']);
+    }
+
+  }
+
+  return I18nLoadingRuntimeModule;
+}

package/packages/client_build_tool/lib/shared/bundler/webpack/custom_plugins/I18nSplitPlugin/getI18nModule.js

@@ -0,0 +1,201 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getI18nModule = getI18nModule;
+
+var _path = _interopRequireDefault(require("path"));
+
+var _constants = require("./constants");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/* eslint-disable no-underscore-dangle */
+const i18nModuleCache = new WeakMap();
+
+function getI18nModule(webpack) {
+  if (i18nModuleCache.has(webpack)) {
+    return i18nModuleCache.get(webpack);
+  }
+
+  class I18nModule extends webpack.Module {
+    constructor({
+      context,
+      identifier,
+      identifierIndex,
+      content,
+      // ## layer,
+      // ## supports,
+      // ## media,
+      // ## sourceMap,
+      assets,
+      assetsInfo
+    }) {
+      super(_constants.MODULE_TYPE, context);
+      this.id = '';
+      this._context = context;
+      this._identifier = identifier;
+      this._identifierIndex = identifierIndex;
+      this.content = content; // ## this.layer = layer;
+      // ## this.supports = supports;
+      // ## this.media = media;
+      // ## this.sourceMap = sourceMap;
+
+      this.assets = assets;
+      this.assetsInfo = assetsInfo;
+      this._needBuild = true;
+    }
+
+    size() {
+      return this.content.length;
+    }
+
+    identifier() {
+      return `i18n|${this._identifier}|${this._identifierIndex}`;
+    }
+
+    readableIdentifier(requestShortener) {
+      return `i18n ${requestShortener.shorten(this._identifier)}${this._identifierIndex ? ` (${this._identifierIndex})` : ''}`;
+    } // eslint-disable-next-line class-methods-use-this
+
+
+    getSourceTypes() {
+      return _constants.TYPES;
+    } // eslint-disable-next-line class-methods-use-this
+
+
+    codeGeneration() {
+      return _constants.CODE_GENERATION_RESULT;
+    }
+
+    nameForCondition() {
+      const resource = this._identifier.split('!').pop();
+
+      const idx = resource.indexOf('?');
+
+      if (idx >= 0) {
+        return resource.substring(0, idx);
+      }
+
+      return resource;
+    }
+
+    updateCacheModule(module) {
+      if (this.content !== module.content || // ## this.layer !== module.layer ||
+      // ## this.supports !== module.supports ||
+      // ## this.media !== module.media ||
+      // ## this.sourceMap !== module.sourceMap ||
+      this.assets !== module.assets || this.assetsInfo !== module.assetsInfo) {
+        this._needBuild = true;
+        this.content = module.content; // ## this.layer = module.layer;
+        // ## this.supports = module.supports;
+        // ## this.media = module.media;
+        // ## this.sourceMap = module.sourceMap;
+
+        this.assets = module.assets;
+        this.assetsInfo = module.assetsInfo;
+      }
+    }
+
+    needRebuild() {
+      return this._needBuild;
+    }
+
+    needBuild(context, callback) {
+      callback(undefined, this._needBuild);
+    }
+
+    build(options, compilation, resolver, fileSystem, callback) {
+      this.buildInfo = {
+        assets: this.assets,
+        assetsInfo: this.assetsInfo,
+        cacheable: true,
+        hash: this._computeHash(compilation.outputOptions.hashFunction)
+      };
+      this.buildMeta = {};
+      this._needBuild = false;
+      callback();
+    }
+
+    _computeHash(hashFunction) {
+      const hash = webpack.util.createHash(hashFunction);
+      hash.update(this.content); // ## if (this.layer) {
+      // ##   hash.update(this.layer);
+      // ## }
+      // ## hash.update(this.supports || '');
+      // ## hash.update(this.media || '');
+      // ## hash.update(this.sourceMap || '');
+
+      return hash.digest('hex');
+    }
+
+    updateHash(hash, context) {
+      super.updateHash(hash, context);
+      hash.update(this.buildInfo.hash);
+    }
+
+    serialize(context) {
+      const {
+        write
+      } = context;
+      write(this._context);
+      write(this._identifier);
+      write(this._identifierIndex);
+      write(this.content); // ## write(this.layer);
+      // ## write(this.supports);
+      // ## write(this.media);
+      // ## write(this.sourceMap);
+
+      write(this.assets);
+      write(this.assetsInfo);
+      write(this._needBuild);
+      super.serialize(context);
+    }
+
+    deserialize(context) {
+      this._needBuild = context.read();
+      super.deserialize(context);
+    }
+
+  }
+
+  i18nModuleCache.set(webpack, I18nModule);
+  webpack.util.serialization.register(I18nModule, _path.default.resolve(__dirname, 'I18nModule-new'), null, {
+    serialize(instance, context) {
+      instance.serialize(context);
+    },
+
+    deserialize(context) {
+      const {
+        read
+      } = context;
+      const contextModule = read();
+      const identifier = read();
+      const identifierIndex = read();
+      const content = read(); // ## const layer = read();
+      // ## const supports = read();
+      // ## const media = read();
+      // ## const sourceMap = read();
+
+      const assets = read();
+      const assetsInfo = read();
+      const dep = new I18nModule({
+        context: contextModule,
+        identifier,
+        identifierIndex,
+        content,
+        // ## layer,
+        // ## supports,
+        // ## media,
+        // ## sourceMap,
+        assets,
+        assetsInfo
+      });
+      dep.deserialize(context);
+      return dep;
+    }
+
+  });
+  return I18nModule;
+}