ilib-tools-common 1.20.1 → 1.21.1

package/lib/Resource.js

@@ -1,7 +1,7 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports["default"]=void 0;function _typeof(o){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(o){return typeof o}:function(o){return o&&"function"==typeof Symbol&&o.constructor===Symbol&&o!==Symbol.prototype?"symbol":typeof o},_typeof(o)}function _classCallCheck(a,n){if(!(a instanceof n))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,r){for(var t=0;t<r.length;t++){var o=r[t];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,_toPropertyKey(o.key),o)}}function _createClass(e,r,t){return r&&_defineProperties(e.prototype,r),t&&_defineProperties(e,t),Object.defineProperty(e,"prototype",{writable:!1}),e}function _defineProperty(e,r,t){return(r=_toPropertyKey(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function _toPropertyKey(t){var i=_toPrimitive(t,"string");return"symbol"==_typeof(i)?i:i+""}function _toPrimitive(t,r){if("object"!=_typeof(t)||!t)return t;var e=t[Symbol.toPrimitive];if(void 0!==e){var i=e.call(t,r||"default");if("object"!=_typeof(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}/*
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports["default"]=exports.VALID_STATES=void 0;exports.isValidState=isValidState;function _typeof(o){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(o){return typeof o}:function(o){return o&&"function"==typeof Symbol&&o.constructor===Symbol&&o!==Symbol.prototype?"symbol":typeof o},_typeof(o)}function _classCallCheck(a,n){if(!(a instanceof n))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,r){for(var t=0;t<r.length;t++){var o=r[t];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,_toPropertyKey(o.key),o)}}function _createClass(e,r,t){return r&&_defineProperties(e.prototype,r),t&&_defineProperties(e,t),Object.defineProperty(e,"prototype",{writable:!1}),e}function _defineProperty(e,r,t){return(r=_toPropertyKey(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function _toPropertyKey(t){var i=_toPrimitive(t,"string");return"symbol"==_typeof(i)?i:i+""}function _toPrimitive(t,r){if("object"!=_typeof(t)||!t)return t;var e=t[Symbol.toPrimitive];if(void 0!==e){var i=e.call(t,r||"default");if("object"!=_typeof(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}/*
  * Resource.js - super class that represents a resource
  *
- * Copyright © 2022-2025 JEDLSoft
+ * Copyright © 2022-2026 JEDLSoft
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,7 +15,41 @@
  *
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */var validStates={"new":true,"translated":true,"accepted":true};var translationImportant=["context","datatype","dnt","flavor","project","reskey","resType","sourceLocale","targetLocale"];/**
+ */var validStates={// XLIFF 2.0 standard states
+// https://docs.oasis-open.org/xliff/xliff-core/v2.0/xliff-core-v2.0.html
+"initial":true,"translated":true,"reviewed":true,"final":true,// XLIFF 1.2 standard states
+// from https://docs.oasis-open.org/xliff/v1.2/os/xliff-core.html
+"new":true,"needs-translation":true,"needs-adaptation":true,"needs-l10n":true,"needs-review-translation":true,"needs-review-adaptation":true,"needs-review-l10n":true,"signed-off":true,// Additional common states used in practice
+"needs-review":true,"fuzzy":true,"accepted":true,"rejected":true,"approved":true,"needs-approval":true};/**
+ * Array of all valid state names that can be used with Resource objects.
+ * This array is sorted alphabetically and includes states from:
+ * - XLIFF 2.0 standard states
+ * - XLIFF 1.2 standard states
+ * - Additional common states used in practice
+ *
+ * Custom states with "x-" prefix are also valid but not included in this array.
+ *
+ * @example
+ * // Check if a state is valid
+ * if (VALID_STATES.includes(state)) {
+ *     console.log('Valid state');
+ * }
+ *
+ * @type {string[]}
+ * @since 1.19.0
+ */var VALID_STATES=exports.VALID_STATES=Object.keys(validStates).sort();/**
+ * Check if a state is valid according to XLIFF 1.2 or 2.0 specification
+ * or if the state is used with ilib projects.
+ *
+ * @param {string} state the state to validate
+ * @returns {boolean} true if the state is valid, false otherwise
+ * @since 1.19.0
+ */function isValidState(state){// Must be a string
+if(typeof state!=="string"){return false}// Empty string is invalid
+if(state.length===0){return false}// Check predefined states first
+if(validStates[state]){return true}// Custom states must start with "x-" and have content after the hyphen
+if(state.startsWith("x-")){// Must have non-whitespace content after "x-"
+var contentAfterX=state.substring(2);if(contentAfterX.trim().length>0){return true}}return false}var translationImportant=["context","datatype","dnt","flavor","project","reskey","resType","sourceLocale","targetLocale"];/**
  * @class Represents a resource from a resource file or
  * extracted from the code.
  * @abstract
@@ -46,6 +80,7 @@
      * @param {string} [props.comment] the comment (translator's note) of this resource
      * @param {boolean} [props.dnt] Do not translate this resource when this is set to true. Default: false
      * @param {string} [props.datatype] the type of file that this resource came from
+     * @param {string} [props.sourceHash] the hash value of a source string
      * @param {string} [props.flavor] the "flavor" of this string, if any. (Android)
      * @param {Location} [props.location] the location in the file given in pathName where this this resource
      * is located
@@ -72,7 +107,7 @@
      */_defineProperty(this,"resfile",void 0);if(this.constructor===Resource){throw new Error("Cannot instantiate abstract class Resource!")}this.autoKey=false;if(props){this.project=props.project;this.context=props.context||undefined;// avoid the empty string
 this.sourceLocale=props.sourceLocale||props.locale;this.targetLocale=props.targetLocale;this.reskey=props.key||props.reskey;this.pathName=props.pathName;this.autoKey=typeof props.autoKey==="boolean"?props.autoKey:false;this.state=props.state||undefined;this.id=props.id;// the database id
 this.formatted=props.formatted;// for Android layout resources
-this.comment=props.comment;this.origin=props.origin||"source";this.dnt=props.dnt;this.datatype=props.datatype;this.sourceHash=props.sourceHash;this.localize=typeof props.localize==="boolean"?props.localize:true;// some files have resources we do not want to localize/translate
+this.comment=props.comment;this.origin=props.origin||"source";this.dnt=props.dnt;this.datatype=props.datatype;this.sourceHash=props.sourceHash||undefined;this.localize=typeof props.localize==="boolean"?props.localize:true;// some files have resources we do not want to localize/translate
 this.flavor=props.flavor;this.index=props.index;this.location=props.location;// optional location of the transunits in the xml file
 this.resfile=props.resfile;// optional resource file path
 this.metadata=props.metadata||undefined}this.instances=[];this.pathName=this.pathName||"";this.dirty=false}/**
@@ -143,6 +178,14 @@ this.metadata=props.metadata||undefined}this.instances=[];this.pathName=this.pat
      *
      * @returns {string} the state of this resource
      */},{key:"getState",value:function getState(){return this.state}/**
+    * Sets the hash value for the source of this resource.
+    *
+    * @param {string} hashValue the hash value to set for this resource.
+    */},{key:"setSourceHash",value:function setSourceHash(hashValue){if(hashValue!==undefined&&typeof hashValue!=="string"){throw new TypeError("hashValue must be a string")}this.sourceHash=hashValue;this.dirty=true}/**
+    * Returns the hash value for the source of this resource.
+    *
+    * @returns {string|undefined} the hash value of this resource.
+    */},{key:"getSourceHash",value:function getSourceHash(){return this.sourceHash}/**
      * Set the project of this resource. This is a string that gives the
      * id of the project for this resource.
      *
@@ -153,7 +196,8 @@ this.metadata=props.metadata||undefined}this.instances=[];this.pathName=this.pat
      * "translated", or "accepted".
      *
      * @param {string} state the state of this resource
-     */},{key:"setState",value:function setState(state){this.state=validStates[state]?state:this.state;this.dirty=true}/**
+     * @throws {Error} if the state is invalid
+     */},{key:"setState",value:function setState(state){if(!isValidState(state)){throw new Error("Attempt to set an invalid state on a resource: \"".concat(state,"\". Valid states are: ").concat(VALID_STATES.join(", "),", or custom states starting with \"x-\""))}this.state=state;this.dirty=true}/**
      * Return the original path to the file from which this resource was
      * originally extracted.
      *
@@ -304,5 +348,5 @@ return"'"+str.replace(/\\'/g,"'").replace(/'/g,"\\'")+"'";case"undefined":return
      *
      * @abstract
      * @returns {string} a unique hash key for this resource with a cleaned string
-     */},{key:"cleanHashKey",value:function cleanHashKey(){throw new Error("cleanHashKey() not implemented")}}])}();var _default=exports["default"]=Resource;module.exports=exports.default;
+     */},{key:"cleanHashKey",value:function cleanHashKey(){throw new Error("cleanHashKey() not implemented")}}])}();var _default=exports["default"]=Resource;
 //# sourceMappingURL=Resource.js.map

package/lib/Resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.js","names":["validStates","translationImportant","Resource","props","_classCallCheck","_defineProperty","constructor","Error","autoKey","project","context","undefined","sourceLocale","locale","targetLocale","reskey","key","pathName","state","id","formatted","comment","origin","dnt","datatype","sourceHash","localize","flavor","index","location","resfile","metadata","instances","dirty","_createClass","value","getProject","getKey","getSource","source","getTarget","target","getType","resType","getDataType","getAutoKey","getContext","getMetadata","setMetadata","data","getSourceLocale","setSourceLocale","getTargetLocale","setTargetLocale","getState","setProject","setState","getPath","getComment","setComment","getDNT","setDNT","flag","TypeError","getId","getOrigin","getLocalize","getFlavor","getResFile","same","other","i","length","escapeText","str","_typeof","replace","toString","addInstance","resource","isInstance","unique","every","res","push","_this","prop","getInstances","isDirty","clearDirty","getLocation","_this$location","hashKey","cleanHashKey","_default","exports","module","default"],"sources":["../src/Resource.js"],"sourcesContent":["/*\n * Resource.js - super class that represents a resource\n *\n * Copyright © 2022-2025 JEDLSoft\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nconst validStates = {\n    \"new\":true,\n    \"translated\":true,\n    \"accepted\":true\n}\n\nconst translationImportant = [\n    \"context\",\n    \"datatype\",\n    \"dnt\",\n    \"flavor\",\n    \"project\",\n    \"reskey\",\n    \"resType\",\n    \"sourceLocale\",\n    \"targetLocale\"\n];\n\n\n/**\n * @class Represents a resource from a resource file or\n * extracted from the code.\n * @abstract\n */\nclass Resource {\n    /**\n     * The type of this resource instance.\n     * @type {String | undefined}\n     */\n    resType;\n\n    /**\n     * The source string or strings for the resource.\n     * @type {String|Array.<String>|Object}\n     */\n    source;\n\n    /**\n     * The target string or strings for the resource.\n     * @type {String|Array.<String>|Object}\n     */\n    target;\n\n    /**\n     * The resource file that this resource was loaded from.\n     * @type {string|undefined}\n     */\n    resfile;\n\n    /**\n     * Construct a new Resource instance.\n     * The props may contain any\n     * of the following properties:\n     *\n     * <ul>\n     * </ul>\n     *\n     * @constructor\n     * @param {Object} props properties of the string, as defined above\n     * @param {string} [props.project] the project that this resource is in\n     * @param {string} [props.context] The context for this resource,\n     * such as \"landscape mode\", or \"7200dp\", which differentiates it\n     * from the base resource that has no special context. The default\n     * if this property is not specified is undefined, meaning no\n     * context.\n     * @param {string} [props.sourceLocale] the locale of the source resource.\n     * @param {string} [props.targetLocale] the locale of the target resource.\n     * @param {string} [props.key] the unique key of this string, which should include the context\n     * of the string\n     * @param {string} [props.pathName] pathName to the file where the string was extracted from\n     * @param {boolean} [props.autoKey] true if the key was generated based on the source text\n     * @param {string} [props.state] current state of the resource (ie. \"new\", \"translated\", or \"accepted\")\n     * @param {string} [props.id] the id of the current resource\n     * @param {string} [props.comment] the comment (translator's note) of this resource\n     * @param {boolean} [props.dnt] Do not translate this resource when this is set to true. Default: false\n     * @param {string} [props.datatype] the type of file that this resource came from\n     * @param {string} [props.flavor] the \"flavor\" of this string, if any. (Android)\n     * @param {Location} [props.location] the location in the file given in pathName where this this resource\n     * is located\n     * @param {string | undefined} [props.resfile] if this resource was extracted from a resource file, this\n     * is the path to the resource file that contains this resource. This is different from the pathName\n     * property, which is the path to the source file that this resource was extracted from. This property\n     * is only used for resources from resource files, such as Android string.xml files or xliff files.\n     * Otherwise, the property is undefined.\n     * @param {Object|undefined} [props.metadata] the metadata of the resource or undefined for no metadata.\n     * This can be any arbitrary object of any depth, as long as the values of properties are all static.\n     * It is up to the parsers to parse this and serializers to serialize this appropriately.\n    */\n    constructor(props) {\n        if (this.constructor === Resource) {\n            throw new Error(\"Cannot instantiate abstract class Resource!\");\n        }\n\n        this.autoKey = false;\n\n        if (props) {\n            this.project = props.project;\n            this.context = props.context || undefined; // avoid the empty string\n            this.sourceLocale = props.sourceLocale || props.locale;\n            this.targetLocale = props.targetLocale;\n            this.reskey = props.key || props.reskey;\n            this.pathName = props.pathName;\n            this.autoKey = typeof(props.autoKey) === \"boolean\" ? props.autoKey : false;\n            this.state = props.state || undefined;\n            this.id = props.id; // the database id\n            this.formatted = props.formatted; // for Android layout resources\n            this.comment = props.comment;\n            this.origin = props.origin || \"source\";\n            this.dnt = props.dnt;\n            this.datatype = props.datatype;\n            this.sourceHash = props.sourceHash;\n            this.localize = typeof(props.localize) === \"boolean\" ? props.localize : true; // some files have resources we do not want to localize/translate\n            this.flavor = props.flavor;\n            this.index = props.index;\n            this.location = props.location; // optional location of the transunits in the xml file\n            this.resfile = props.resfile; // optional resource file path\n            this.metadata = props.metadata || undefined;\n        }\n\n        this.instances = [];\n        this.pathName = this.pathName || \"\";\n        this.dirty = false;\n    }\n\n    /**\n     * Return the project that this resource was found in.\n     *\n     * @returns {string} the project of this resource\n     */\n    getProject() {\n        return this.project;\n    }\n\n    /**\n     * Return the unique key of this resource.\n     *\n     * @returns {string} the unique key of this resource\n     */\n    getKey() {\n        return this.reskey;\n    }\n\n    /**\n     * Return the source string or strings for this resource.\n     *\n     * @returns {String|Array.<String>|Object} the source string or\n     * strings of this resource\n     */\n    getSource() {\n        return this.source;\n    }\n\n    /**\n     * Return the target string or strings for this resource.\n     *\n     * @returns {String|Array.<String>|Object|undefined} the source string or\n     * strings of this resource\n     */\n    getTarget() {\n        return this.target;\n    }\n\n    /**\n     * Return the resource type of this resource. This is one of\n     * string, array, or plural.\n     *\n     * @returns {string} the resource type of this resource\n     */\n    getType() {\n        return this.resType || \"string\";\n    }\n\n    /**\n     * Return the data type of this resource.\n     *\n     * @returns {string} the data type of this resource\n     */\n    getDataType() {\n        return this.datatype;\n    }\n\n    /**\n     * Return true if the key of this resource was automatically generated,\n     * and false if it was an explicit key.\n     *\n     * @returns {boolean} true if the key of this string was auto generated,\n     * false otherwise\n     */\n    getAutoKey() {\n        return this.autoKey;\n    }\n\n    /**\n     * Return the context of this resource, or undefined if there\n     * is no context.\n     * @returns {String|undefined} the context of this resource, or undefined if there\n     * is no context.\n     */\n    getContext() {\n        return this.context;\n    }\n\n    /**\n    * Get the metadata of this resource.\n    *\n    * @returns {Object|undefined} the metadata of this resource.\n    */\n    getMetadata() {\n        return this.metadata;\n    }\n\n    /**\n    * Set the metadata of this resource.\n    * @param {Object|undefined} data the metadata of this resource.\n    */\n    setMetadata(data) {\n        this.metadata = data;\n    }\n\n    /**\n     * Return the source locale of this resource, or undefined if there\n     * is no context or the locale is the same as the project's source locale.\n     * @returns {String|undefined} the locale of this resource, or undefined if there\n     * is no locale.\n     */\n    getSourceLocale() {\n        return this.sourceLocale || \"en-US\";\n    }\n\n    /**\n     * Set the source locale of this resource.\n     * @param {string} locale the source locale of this resource\n     */\n    setSourceLocale(locale) {\n        this.sourceLocale = locale || this.sourceLocale;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the target locale of this resource, or undefined if the resource\n     * is a source-only resource.\n     * @returns {String|undefined} the locale of this resource, or undefined if there\n     * is no locale.\n     */\n    getTargetLocale() {\n        return this.targetLocale;\n    }\n\n    /**\n     * Set the target locale of this resource.\n     * @param {string} locale the target locale of this resource\n     */\n    setTargetLocale(locale) {\n        this.targetLocale = locale || this.targetLocale;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the state of this resource. This is a string that gives the\n     * stage of life of this resource. Currently, it can be one of \"new\",\n     * \"translated\", or \"accepted\".\n     *\n     * @returns {string} the state of this resource\n     */\n    getState() {\n        return this.state;\n    }\n\n    /**\n     * Set the project of this resource. This is a string that gives the\n     * id of the project for this resource.\n     *\n     * @param {string} project the project name to set for this resource\n     */\n    setProject(project) {\n        this.project = project;\n        this.dirty = true;\n    }\n\n    /**\n     * Set the state of this resource. This is a string that gives the\n     * stage of life of this resource. Currently, it can be one of \"new\",\n     * \"translated\", or \"accepted\".\n     *\n     * @param {string} state the state of this resource\n     */\n    setState(state) {\n        this.state = validStates[state] ? state : this.state;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the original path to the file from which this resource was\n     * originally extracted.\n     *\n     * @returns {string} the path to the file containing this resource\n     */\n    getPath() {\n        return this.pathName;\n    }\n\n    /**\n     * Return the translator's comment for this resource if there is\n     * one, or undefined if not.\n     *\n     * @returns {String|undefined} the translator's comment for this resource\n     * if the engineer put one in the code\n     */\n    getComment() {\n        return this.comment;\n    }\n\n    /**\n     * Set the translator's comment for this resource.\n     *\n     * @param {String|undefined} comment the translator's comment to set. Use\n     * undefined to clear the comment\n     */\n    setComment(comment) {\n        this.comment = comment;\n        this.dirty = true;\n    }\n\n    /**\n     * Get the \"do not translate\" flag for this resource.\n     *\n     * @returns {boolean} true means that the current resource should not\n     * be translated, and false means it will be translated.\n     */\n    getDNT() {\n        return typeof(this.dnt) === 'boolean' ? this.dnt : false;\n    }\n\n    /**\n     * Set the \"do not translate\" flag for this resource.\n     *\n     * @param {boolean} flag set the dnt flag to this value\n     */\n    setDNT(flag) {\n        if (typeof(flag) !== 'boolean') {\n            throw new TypeError('value must be boolean');\n        }\n        this.dnt = flag;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the database id if this resource has previously been saved in the\n     * database.\n     *\n     * @returns {number|undefined} the database id if this resource has previously\n     * been saved in the database, or undefined if it is has not\n     */\n    getId() {\n        return this.id;\n    }\n\n    /**\n     * Return the origin of this resource. The origin may be either the string\n     * \"source\" or \"target\". Source origin resources are ones that are extracted\n     * from the source code, whereas target ones are translations from the\n     * translators.\n     *\n     * @returns {string} the origin of this resource\n     */\n    getOrigin() {\n        return this.origin;\n    }\n\n    /**\n     * Return the localize flag of this resource.\n     * This flag indicates whether we should look up a translation for this resource.\n     * When false, we should simply substitute the source back\n     *\n     * @returns {Boolean} the localize flag of this resource\n     */\n    getLocalize() {\n      return this.localize;\n    }\n\n    /**\n     * Return the name of the flavor for this resource, or undefined\n     * for the \"main\" or default flavor.\n     *\n     *  @return {String|undefined} the name of the flavor for this\n     *  resource or undefined for the main or default flavor\n     */\n    getFlavor() {\n        return this.flavor;\n    }\n\n    /**\n     * Return the path to the resource file that contains this resource.\n     * This is different from the pathName property, which is the path to\n     * the source file that this resource was extracted from. This property\n     * is only used for resources from resource files, such as Android\n     * string.xml files or xliff files. Otherwise, the property is undefined.\n     *\n     * @returns {string|undefined} the path to the resource file that contains\n     * this resource, or undefined if this resource was not extracted from\n     * a resource file\n     */\n    getResFile() {\n        return this.resfile;\n    }\n\n    /**\n     * Return true if the other resource represents the same resource as\n     * the current one. The project, context, locale, key, flavor, and type must\n     * match. Other fields such as the pathName, state, and comment fields are\n     * ignored as minor variations.\n     *\n     * @param {Resource} other another resource to test against the current one\n     * @returns {boolean} true if these represent the same resource, false otherwise\n     */\n    same(other) {\n        if (!other) return false;\n\n        const props = [\"project\", \"context\", \"sourceLocale\", \"targetLocale\", \"reskey\", \"resType\", \"flavor\"];\n        for (let i = 0; i < props.length; i++) {\n            if (this[props[i]] !== other[props[i]]) {\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n    /**\n     * Escape text for writing to a database in a SQL command. This puts single\n     * quotes around the string, and makes sure that all single quotes within\n     * the string are escaped.\n     *\n     * @param {Object} str the item to escape\n     * @returns {string} the escaped string\n     */\n    escapeText(str) {\n        switch (typeof(str)) {\n        case \"string\":\n            // unescape first, then re-escape to make everything consistent\n            return \"'\" + str.replace(/\\\\'/g, \"'\").replace(/'/g, \"\\\\'\") + \"'\";\n        case \"undefined\":\n            return \"NULL\";\n        case \"boolean\":\n            return str ? \"TRUE\" : \"FALSE\";\n        default:\n            if (str === null) {\n                return \"NULL\";\n            }\n            return str.toString();\n        }\n    }\n\n    /**\n     * Add an instance of the same resource to the list of\n     * instances. If the given resource matches the\n     * current instance in all properties that affect the\n     * possible translation, and differs from the current\n     * instance by some property that does not affect\n     * its translation, it will be added as an instance of\n     * the same string. The following properties affect the\n     * translation:\n     *\n     * <ul>\n     * <li>context</li>\n     * <li>datatype</li>\n     * <li>dnt</li>\n     * <li>flavor</li>\n     * <li>project</li>\n     * <li>reskey</li>\n     * <li>resType</li>\n     * <li>source</li>\n     * <li>sourceHash</li>\n     * <li>sourceArray</li>\n     * <li>sourceLocale</li>\n     * <li>targetLocale</li>\n     * </ul>\n     *\n     * Differences in other properties, such as \"comment\" or\n     * \"origin\" are considered instances of the same resource.\n     *\n     * If this method is given a resource that differs from\n     * the current one by one of the above translation affecting\n     * properties, it is not added to the list of instances. This\n     * can be checked easily by calling the isInstance() method.\n     *\n     * @param {Resource} resource an instance of the current resource to\n     * record\n     * @returns {boolean} true if the instance was added, and\n     * and false otherwise\n     */\n    addInstance(resource) {\n        if (!this.isInstance(resource)) {\n            return false;\n        }\n        const unique = this !== resource && this.instances.every(res => {\n            return res !== resource;\n        });\n        if (!unique) {\n            return false;\n        }\n        this.instances.push(resource);\n        this.dirty = true;\n        return true;\n    }\n\n    /**\n     * Check if the given resource is an instance of the current\n     * resource. This method returns true if all properties which\n     * affect the possible translation match between the given and\n     * the current resource.\n     *\n     * @param {Resource} resource a resource to check\n     * @returns {boolean} true if this is an instance of\n     * the current resource, false otherwise.\n     */\n    isInstance(resource) {\n        if (typeof(resource) !== 'object' || !(resource instanceof Resource)) {\n            return false;\n        }\n\n        return translationImportant.every(prop => {\n            return this[prop] === resource[prop];\n        });\n    }\n\n    /**\n     * Return the list of instances of the current resource.\n     *\n     * @returns {Array.<Resource>} the list of instances of\n     * the current resource\n     */\n    getInstances() {\n        return this.instances;\n    }\n\n    /**\n     * Return true if this instance has been modified since its creation, and false otherwise.\n     */\n    isDirty() {\n        return this.dirty\n    }\n\n    /**\n     * Clear the dirty flag. This is used for example when the Resource was\n     * written to disk and the modifications are already recorded, allowing\n     * new modifications later.\n     */\n    clearDirty() {\n        this.dirty = false;\n    }\n\n    /**\n     * Return the location of the resource instance in the original file where it was read\n     * from. This is usually an object containing a line and a char property which gives the\n     * line number and character within that line where the representation of the resource\n     * instance starts.\n     *\n     * @returns {Location|undefined} the location information, or undefined if no location\n     * information is available\n     */\n    getLocation() {\n        return this.location?.getLocation();\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource.\n     *\n     * @abstract\n     * @returns {string} a unique hash key for this resource\n     */\n    hashKey() {\n        throw new Error(\"hashKey() not implemented\");\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource, but uses the cleaned version of the string\n     *\n     * @abstract\n     * @returns {string} a unique hash key for this resource with a cleaned string\n     */\n    cleanHashKey() {\n        throw new Error(\"cleanHashKey() not implemented\");\n    }\n}\n\nexport default Resource;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Resource.js","names":["validStates","VALID_STATES","exports","Object","keys","sort","isValidState","state","length","startsWith","contentAfterX","substring","trim","translationImportant","Resource","props","_classCallCheck","_defineProperty","constructor","Error","autoKey","project","context","undefined","sourceLocale","locale","targetLocale","reskey","key","pathName","id","formatted","comment","origin","dnt","datatype","sourceHash","localize","flavor","index","location","resfile","metadata","instances","dirty","_createClass","value","getProject","getKey","getSource","source","getTarget","target","getType","resType","getDataType","getAutoKey","getContext","getMetadata","setMetadata","data","getSourceLocale","setSourceLocale","getTargetLocale","setTargetLocale","getState","setSourceHash","hashValue","TypeError","getSourceHash","setProject","setState","concat","join","getPath","getComment","setComment","getDNT","setDNT","flag","getId","getOrigin","getLocalize","getFlavor","getResFile","same","other","i","escapeText","str","_typeof","replace","toString","addInstance","resource","isInstance","unique","every","res","push","_this","prop","getInstances","isDirty","clearDirty","getLocation","_this$location","hashKey","cleanHashKey","_default"],"sources":["../src/Resource.js"],"sourcesContent":["/*\n * Resource.js - super class that represents a resource\n *\n * Copyright © 2022-2026 JEDLSoft\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nconst validStates = {\n    // XLIFF 2.0 standard states\n    // https://docs.oasis-open.org/xliff/xliff-core/v2.0/xliff-core-v2.0.html\n    \"initial\": true,\n    \"translated\": true,\n    \"reviewed\": true,\n    \"final\": true,\n\n    // XLIFF 1.2 standard states\n    // from https://docs.oasis-open.org/xliff/v1.2/os/xliff-core.html\n    \"new\": true,\n    \"needs-translation\": true,\n    \"needs-adaptation\": true,\n    \"needs-l10n\": true,\n    \"needs-review-translation\": true,\n    \"needs-review-adaptation\": true,\n    \"needs-review-l10n\": true,\n    \"signed-off\": true,\n\n    // Additional common states used in practice\n    \"needs-review\": true,\n    \"fuzzy\": true,\n    \"accepted\": true,\n    \"rejected\": true,\n    \"approved\": true,\n    \"needs-approval\": true\n};\n\n/**\n * Array of all valid state names that can be used with Resource objects.\n * This array is sorted alphabetically and includes states from:\n * - XLIFF 2.0 standard states\n * - XLIFF 1.2 standard states\n * - Additional common states used in practice\n *\n * Custom states with \"x-\" prefix are also valid but not included in this array.\n *\n * @example\n * // Check if a state is valid\n * if (VALID_STATES.includes(state)) {\n *     console.log('Valid state');\n * }\n *\n * @type {string[]}\n * @since 1.19.0\n */\nexport const VALID_STATES = Object.keys(validStates).sort();\n\n/**\n * Check if a state is valid according to XLIFF 1.2 or 2.0 specification\n * or if the state is used with ilib projects.\n *\n * @param {string} state the state to validate\n * @returns {boolean} true if the state is valid, false otherwise\n * @since 1.19.0\n */\nfunction isValidState(state) {\n    // Must be a string\n    if (typeof state !== 'string') {\n        return false;\n    }\n\n    // Empty string is invalid\n    if (state.length === 0) {\n        return false;\n    }\n\n    // Check predefined states first\n    if (validStates[state]) {\n        return true;\n    }\n\n    // Custom states must start with \"x-\" and have content after the hyphen\n    if (state.startsWith('x-')) {\n        // Must have non-whitespace content after \"x-\"\n        const contentAfterX = state.substring(2);\n        if (contentAfterX.trim().length > 0) {\n            return true;\n        }\n    }\n\n    return false;\n}\n\nexport { isValidState };\n\nconst translationImportant = [\n    \"context\",\n    \"datatype\",\n    \"dnt\",\n    \"flavor\",\n    \"project\",\n    \"reskey\",\n    \"resType\",\n    \"sourceLocale\",\n    \"targetLocale\"\n];\n\n\n/**\n * @class Represents a resource from a resource file or\n * extracted from the code.\n * @abstract\n */\nclass Resource {\n    /**\n     * The type of this resource instance.\n     * @type {String | undefined}\n     */\n    resType;\n\n    /**\n     * The source string or strings for the resource.\n     * @type {String|Array.<String>|Object}\n     */\n    source;\n\n    /**\n     * The target string or strings for the resource.\n     * @type {String|Array.<String>|Object}\n     */\n    target;\n\n    /**\n     * The resource file that this resource was loaded from.\n     * @type {string|undefined}\n     */\n    resfile;\n\n    /**\n     * Construct a new Resource instance.\n     * The props may contain any\n     * of the following properties:\n     *\n     * <ul>\n     * </ul>\n     *\n     * @constructor\n     * @param {Object} props properties of the string, as defined above\n     * @param {string} [props.project] the project that this resource is in\n     * @param {string} [props.context] The context for this resource,\n     * such as \"landscape mode\", or \"7200dp\", which differentiates it\n     * from the base resource that has no special context. The default\n     * if this property is not specified is undefined, meaning no\n     * context.\n     * @param {string} [props.sourceLocale] the locale of the source resource.\n     * @param {string} [props.targetLocale] the locale of the target resource.\n     * @param {string} [props.key] the unique key of this string, which should include the context\n     * of the string\n     * @param {string} [props.pathName] pathName to the file where the string was extracted from\n     * @param {boolean} [props.autoKey] true if the key was generated based on the source text\n     * @param {string} [props.state] current state of the resource (ie. \"new\", \"translated\", or \"accepted\")\n     * @param {string} [props.id] the id of the current resource\n     * @param {string} [props.comment] the comment (translator's note) of this resource\n     * @param {boolean} [props.dnt] Do not translate this resource when this is set to true. Default: false\n     * @param {string} [props.datatype] the type of file that this resource came from\n     * @param {string} [props.sourceHash] the hash value of a source string\n     * @param {string} [props.flavor] the \"flavor\" of this string, if any. (Android)\n     * @param {Location} [props.location] the location in the file given in pathName where this this resource\n     * is located\n     * @param {string | undefined} [props.resfile] if this resource was extracted from a resource file, this\n     * is the path to the resource file that contains this resource. This is different from the pathName\n     * property, which is the path to the source file that this resource was extracted from. This property\n     * is only used for resources from resource files, such as Android string.xml files or xliff files.\n     * Otherwise, the property is undefined.\n     * @param {Object|undefined} [props.metadata] the metadata of the resource or undefined for no metadata.\n     * This can be any arbitrary object of any depth, as long as the values of properties are all static.\n     * It is up to the parsers to parse this and serializers to serialize this appropriately.\n    */\n    constructor(props) {\n        if (this.constructor === Resource) {\n            throw new Error(\"Cannot instantiate abstract class Resource!\");\n        }\n\n        this.autoKey = false;\n\n        if (props) {\n            this.project = props.project;\n            this.context = props.context || undefined; // avoid the empty string\n            this.sourceLocale = props.sourceLocale || props.locale;\n            this.targetLocale = props.targetLocale;\n            this.reskey = props.key || props.reskey;\n            this.pathName = props.pathName;\n            this.autoKey = typeof(props.autoKey) === \"boolean\" ? props.autoKey : false;\n            this.state = props.state || undefined;\n            this.id = props.id; // the database id\n            this.formatted = props.formatted; // for Android layout resources\n            this.comment = props.comment;\n            this.origin = props.origin || \"source\";\n            this.dnt = props.dnt;\n            this.datatype = props.datatype;\n            this.sourceHash = props.sourceHash || undefined;\n            this.localize = typeof(props.localize) === \"boolean\" ? props.localize : true; // some files have resources we do not want to localize/translate\n            this.flavor = props.flavor;\n            this.index = props.index;\n            this.location = props.location; // optional location of the transunits in the xml file\n            this.resfile = props.resfile; // optional resource file path\n            this.metadata = props.metadata || undefined;\n        }\n\n        this.instances = [];\n        this.pathName = this.pathName || \"\";\n        this.dirty = false;\n    }\n\n    /**\n     * Return the project that this resource was found in.\n     *\n     * @returns {string} the project of this resource\n     */\n    getProject() {\n        return this.project;\n    }\n\n    /**\n     * Return the unique key of this resource.\n     *\n     * @returns {string} the unique key of this resource\n     */\n    getKey() {\n        return this.reskey;\n    }\n\n    /**\n     * Return the source string or strings for this resource.\n     *\n     * @returns {String|Array.<String>|Object} the source string or\n     * strings of this resource\n     */\n    getSource() {\n        return this.source;\n    }\n\n    /**\n     * Return the target string or strings for this resource.\n     *\n     * @returns {String|Array.<String>|Object|undefined} the source string or\n     * strings of this resource\n     */\n    getTarget() {\n        return this.target;\n    }\n\n    /**\n     * Return the resource type of this resource. This is one of\n     * string, array, or plural.\n     *\n     * @returns {string} the resource type of this resource\n     */\n    getType() {\n        return this.resType || \"string\";\n    }\n\n    /**\n     * Return the data type of this resource.\n     *\n     * @returns {string} the data type of this resource\n     */\n    getDataType() {\n        return this.datatype;\n    }\n\n    /**\n     * Return true if the key of this resource was automatically generated,\n     * and false if it was an explicit key.\n     *\n     * @returns {boolean} true if the key of this string was auto generated,\n     * false otherwise\n     */\n    getAutoKey() {\n        return this.autoKey;\n    }\n\n    /**\n     * Return the context of this resource, or undefined if there\n     * is no context.\n     * @returns {String|undefined} the context of this resource, or undefined if there\n     * is no context.\n     */\n    getContext() {\n        return this.context;\n    }\n\n    /**\n    * Get the metadata of this resource.\n    *\n    * @returns {Object|undefined} the metadata of this resource.\n    */\n    getMetadata() {\n        return this.metadata;\n    }\n\n    /**\n    * Set the metadata of this resource.\n    * @param {Object|undefined} data the metadata of this resource.\n    */\n    setMetadata(data) {\n        this.metadata = data;\n    }\n\n    /**\n     * Return the source locale of this resource, or undefined if there\n     * is no context or the locale is the same as the project's source locale.\n     * @returns {String|undefined} the locale of this resource, or undefined if there\n     * is no locale.\n     */\n    getSourceLocale() {\n        return this.sourceLocale || \"en-US\";\n    }\n\n    /**\n     * Set the source locale of this resource.\n     * @param {string} locale the source locale of this resource\n     */\n    setSourceLocale(locale) {\n        this.sourceLocale = locale || this.sourceLocale;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the target locale of this resource, or undefined if the resource\n     * is a source-only resource.\n     * @returns {String|undefined} the locale of this resource, or undefined if there\n     * is no locale.\n     */\n    getTargetLocale() {\n        return this.targetLocale;\n    }\n\n    /**\n     * Set the target locale of this resource.\n     * @param {string} locale the target locale of this resource\n     */\n    setTargetLocale(locale) {\n        this.targetLocale = locale || this.targetLocale;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the state of this resource. This is a string that gives the\n     * stage of life of this resource. Currently, it can be one of \"new\",\n     * \"translated\", or \"accepted\".\n     *\n     * @returns {string} the state of this resource\n     */\n    getState() {\n        return this.state;\n    }\n\n    /**\n    * Sets the hash value for the source of this resource.\n    *\n    * @param {string} hashValue the hash value to set for this resource.\n    */\n    setSourceHash(hashValue) {\n        if (hashValue !== undefined && typeof hashValue !== 'string') {\n            throw new TypeError('hashValue must be a string');\n        }\n        this.sourceHash = hashValue;\n        this.dirty = true;\n    }\n\n    /**\n    * Returns the hash value for the source of this resource.\n    *\n    * @returns {string|undefined} the hash value of this resource.\n    */\n    getSourceHash() {\n        return this.sourceHash;\n    }\n\n    /**\n     * Set the project of this resource. This is a string that gives the\n     * id of the project for this resource.\n     *\n     * @param {string} project the project name to set for this resource\n     */\n    setProject(project) {\n        this.project = project;\n        this.dirty = true;\n    }\n\n    /**\n     * Set the state of this resource. This is a string that gives the\n     * stage of life of this resource. Currently, it can be one of \"new\",\n     * \"translated\", or \"accepted\".\n     *\n     * @param {string} state the state of this resource\n     * @throws {Error} if the state is invalid\n     */\n    setState(state) {\n        if (!isValidState(state)) {\n            throw new Error(`Attempt to set an invalid state on a resource: \"${state}\". Valid states are: ${VALID_STATES.join(', ')}, or custom states starting with \"x-\"`);\n        }\n        this.state = state;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the original path to the file from which this resource was\n     * originally extracted.\n     *\n     * @returns {string} the path to the file containing this resource\n     */\n    getPath() {\n        return this.pathName;\n    }\n\n    /**\n     * Return the translator's comment for this resource if there is\n     * one, or undefined if not.\n     *\n     * @returns {String|undefined} the translator's comment for this resource\n     * if the engineer put one in the code\n     */\n    getComment() {\n        return this.comment;\n    }\n\n    /**\n     * Set the translator's comment for this resource.\n     *\n     * @param {String|undefined} comment the translator's comment to set. Use\n     * undefined to clear the comment\n     */\n    setComment(comment) {\n        this.comment = comment;\n        this.dirty = true;\n    }\n\n    /**\n     * Get the \"do not translate\" flag for this resource.\n     *\n     * @returns {boolean} true means that the current resource should not\n     * be translated, and false means it will be translated.\n     */\n    getDNT() {\n        return typeof(this.dnt) === 'boolean' ? this.dnt : false;\n    }\n\n    /**\n     * Set the \"do not translate\" flag for this resource.\n     *\n     * @param {boolean} flag set the dnt flag to this value\n     */\n    setDNT(flag) {\n        if (typeof(flag) !== 'boolean') {\n            throw new TypeError('value must be boolean');\n        }\n        this.dnt = flag;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the database id if this resource has previously been saved in the\n     * database.\n     *\n     * @returns {number|undefined} the database id if this resource has previously\n     * been saved in the database, or undefined if it is has not\n     */\n    getId() {\n        return this.id;\n    }\n\n    /**\n     * Return the origin of this resource. The origin may be either the string\n     * \"source\" or \"target\". Source origin resources are ones that are extracted\n     * from the source code, whereas target ones are translations from the\n     * translators.\n     *\n     * @returns {string} the origin of this resource\n     */\n    getOrigin() {\n        return this.origin;\n    }\n\n    /**\n     * Return the localize flag of this resource.\n     * This flag indicates whether we should look up a translation for this resource.\n     * When false, we should simply substitute the source back\n     *\n     * @returns {Boolean} the localize flag of this resource\n     */\n    getLocalize() {\n      return this.localize;\n    }\n\n    /**\n     * Return the name of the flavor for this resource, or undefined\n     * for the \"main\" or default flavor.\n     *\n     *  @return {String|undefined} the name of the flavor for this\n     *  resource or undefined for the main or default flavor\n     */\n    getFlavor() {\n        return this.flavor;\n    }\n\n    /**\n     * Return the path to the resource file that contains this resource.\n     * This is different from the pathName property, which is the path to\n     * the source file that this resource was extracted from. This property\n     * is only used for resources from resource files, such as Android\n     * string.xml files or xliff files. Otherwise, the property is undefined.\n     *\n     * @returns {string|undefined} the path to the resource file that contains\n     * this resource, or undefined if this resource was not extracted from\n     * a resource file\n     */\n    getResFile() {\n        return this.resfile;\n    }\n\n    /**\n     * Return true if the other resource represents the same resource as\n     * the current one. The project, context, locale, key, flavor, and type must\n     * match. Other fields such as the pathName, state, and comment fields are\n     * ignored as minor variations.\n     *\n     * @param {Resource} other another resource to test against the current one\n     * @returns {boolean} true if these represent the same resource, false otherwise\n     */\n    same(other) {\n        if (!other) return false;\n\n        const props = [\"project\", \"context\", \"sourceLocale\", \"targetLocale\", \"reskey\", \"resType\", \"flavor\"];\n        for (let i = 0; i < props.length; i++) {\n            if (this[props[i]] !== other[props[i]]) {\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n    /**\n     * Escape text for writing to a database in a SQL command. This puts single\n     * quotes around the string, and makes sure that all single quotes within\n     * the string are escaped.\n     *\n     * @param {Object} str the item to escape\n     * @returns {string} the escaped string\n     */\n    escapeText(str) {\n        switch (typeof(str)) {\n        case \"string\":\n            // unescape first, then re-escape to make everything consistent\n            return \"'\" + str.replace(/\\\\'/g, \"'\").replace(/'/g, \"\\\\'\") + \"'\";\n        case \"undefined\":\n            return \"NULL\";\n        case \"boolean\":\n            return str ? \"TRUE\" : \"FALSE\";\n        default:\n            if (str === null) {\n                return \"NULL\";\n            }\n            return str.toString();\n        }\n    }\n\n    /**\n     * Add an instance of the same resource to the list of\n     * instances. If the given resource matches the\n     * current instance in all properties that affect the\n     * possible translation, and differs from the current\n     * instance by some property that does not affect\n     * its translation, it will be added as an instance of\n     * the same string. The following properties affect the\n     * translation:\n     *\n     * <ul>\n     * <li>context</li>\n     * <li>datatype</li>\n     * <li>dnt</li>\n     * <li>flavor</li>\n     * <li>project</li>\n     * <li>reskey</li>\n     * <li>resType</li>\n     * <li>source</li>\n     * <li>sourceHash</li>\n     * <li>sourceArray</li>\n     * <li>sourceLocale</li>\n     * <li>targetLocale</li>\n     * </ul>\n     *\n     * Differences in other properties, such as \"comment\" or\n     * \"origin\" are considered instances of the same resource.\n     *\n     * If this method is given a resource that differs from\n     * the current one by one of the above translation affecting\n     * properties, it is not added to the list of instances. This\n     * can be checked easily by calling the isInstance() method.\n     *\n     * @param {Resource} resource an instance of the current resource to\n     * record\n     * @returns {boolean} true if the instance was added, and\n     * and false otherwise\n     */\n    addInstance(resource) {\n        if (!this.isInstance(resource)) {\n            return false;\n        }\n        const unique = this !== resource && this.instances.every(res => {\n            return res !== resource;\n        });\n        if (!unique) {\n            return false;\n        }\n        this.instances.push(resource);\n        this.dirty = true;\n        return true;\n    }\n\n    /**\n     * Check if the given resource is an instance of the current\n     * resource. This method returns true if all properties which\n     * affect the possible translation match between the given and\n     * the current resource.\n     *\n     * @param {Resource} resource a resource to check\n     * @returns {boolean} true if this is an instance of\n     * the current resource, false otherwise.\n     */\n    isInstance(resource) {\n        if (typeof(resource) !== 'object' || !(resource instanceof Resource)) {\n            return false;\n        }\n\n        return translationImportant.every(prop => {\n            return this[prop] === resource[prop];\n        });\n    }\n\n    /**\n     * Return the list of instances of the current resource.\n     *\n     * @returns {Array.<Resource>} the list of instances of\n     * the current resource\n     */\n    getInstances() {\n        return this.instances;\n    }\n\n    /**\n     * Return true if this instance has been modified since its creation, and false otherwise.\n     */\n    isDirty() {\n        return this.dirty\n    }\n\n    /**\n     * Clear the dirty flag. This is used for example when the Resource was\n     * written to disk and the modifications are already recorded, allowing\n     * new modifications later.\n     */\n    clearDirty() {\n        this.dirty = false;\n    }\n\n    /**\n     * Return the location of the resource instance in the original file where it was read\n     * from. This is usually an object containing a line and a char property which gives the\n     * line number and character within that line where the representation of the resource\n     * instance starts.\n     *\n     * @returns {Location|undefined} the location information, or undefined if no location\n     * information is available\n     */\n    getLocation() {\n        return this.location?.getLocation();\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource.\n     *\n     * @abstract\n     * @returns {string} a unique hash key for this resource\n     */\n    hashKey() {\n        throw new Error(\"hashKey() not implemented\");\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource, but uses the cleaned version of the string\n     *\n     * @abstract\n     * @returns {string} a unique hash key for this resource with a cleaned string\n     */\n    cleanHashKey() {\n        throw new Error(\"cleanHashKey() not implemented\");\n    }\n}\n\nexport default Resource;\n"],"mappings":"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","ignoreList":[]}

package/lib/ResourceString.js

@@ -1,7 +1,7 @@
 "use strict";function _typeof(o){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(o){return typeof o}:function(o){return o&&"function"==typeof Symbol&&o.constructor===Symbol&&o!==Symbol.prototype?"symbol":typeof o},_typeof(o)}Object.defineProperty(exports,"__esModule",{value:true});exports["default"]=void 0;var _Resource2=_interopRequireDefault(require("./Resource.js"));var _utils=require("./utils.js");var _log4jsApi=_interopRequireDefault(require("@log4js-node/log4js-api"));function _interopRequireDefault(e){return e&&e.__esModule?e:{"default":e}}function _classCallCheck(a,n){if(!(a instanceof n))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,r){for(var t=0;t<r.length;t++){var o=r[t];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,_toPropertyKey(o.key),o)}}function _createClass(e,r,t){return r&&_defineProperties(e.prototype,r),t&&_defineProperties(e,t),Object.defineProperty(e,"prototype",{writable:!1}),e}function _toPropertyKey(t){var i=_toPrimitive(t,"string");return"symbol"==_typeof(i)?i:i+""}function _toPrimitive(t,r){if("object"!=_typeof(t)||!t)return t;var e=t[Symbol.toPrimitive];if(void 0!==e){var i=e.call(t,r||"default");if("object"!=_typeof(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}function _callSuper(t,o,e){return o=_getPrototypeOf(o),_possibleConstructorReturn(t,_isNativeReflectConstruct()?Reflect.construct(o,e||[],_getPrototypeOf(t).constructor):o.apply(t,e))}function _possibleConstructorReturn(t,e){if(e&&("object"==_typeof(e)||"function"==typeof e))return e;if(void 0!==e)throw new TypeError("Derived constructors may only return object or undefined");return _assertThisInitialized(t)}function _assertThisInitialized(e){if(void 0===e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return e}function _isNativeReflectConstruct(){try{var t=!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}))}catch(t){}return(_isNativeReflectConstruct=function _isNativeReflectConstruct(){return!!t})()}function _superPropGet(t,o,e,r){var p=_get(_getPrototypeOf(1&r?t.prototype:t),o,e);return 2&r&&"function"==typeof p?function(t){return p.apply(e,t)}:p}function _get(){return _get="undefined"!=typeof Reflect&&Reflect.get?Reflect.get.bind():function(e,t,r){var p=_superPropBase(e,t);if(p){var n=Object.getOwnPropertyDescriptor(p,t);return n.get?n.get.call(arguments.length<3?e:r):n.value}},_get.apply(null,arguments)}function _superPropBase(t,o){for(;!{}.hasOwnProperty.call(t,o)&&null!==(t=_getPrototypeOf(t)););return t}function _getPrototypeOf(t){return _getPrototypeOf=Object.setPrototypeOf?Object.getPrototypeOf.bind():function(t){return t.__proto__||Object.getPrototypeOf(t)},_getPrototypeOf(t)}function _inherits(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Super expression must either be null or a function");t.prototype=Object.create(e&&e.prototype,{constructor:{value:t,writable:!0,configurable:!0}}),Object.defineProperty(t,"prototype",{writable:!1}),e&&_setPrototypeOf(t,e)}function _setPrototypeOf(t,e){return _setPrototypeOf=Object.setPrototypeOf?Object.setPrototypeOf.bind():function(t,e){return t.__proto__=e,t},_setPrototypeOf(t,e)}/*
  * ResourceString.js - represents an string in a resource file
  *
- * Copyright © 2022-2023 JEDLSoft
+ * Copyright © 2022-2023, 2026 JEDLSoft
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -64,29 +64,30 @@
      * @param {String} datatype the datatype of the string
      * @param {String} flavor the flavor of the string
      * @param {String} context the context of the string
+     * @param {String} sourceHash the sourceHash of the string
      * @static
      * @return {String} a hash key
      */},{key:"hashKey",value:/**
      * Return the a hash key that uniquely identifies this resource.
      *
      *  @return {String} a unique hash key for this resource
-     */function hashKey(){var locale=this.targetLocale||this.getSourceLocale();return ResourceString.hashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context)}/**
+     */function hashKey(){var locale=this.targetLocale||this.getSourceLocale();return ResourceString.hashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context,this.sourceHash)}/**
      * Return the a hash key that uniquely identifies the translation of
      * this resource to the given locale.
      *
      * @param {String} locale a locale spec of the desired translation
      * @return {String} a unique hash key for this resource
-     */},{key:"hashKeyForTranslation",value:function hashKeyForTranslation(locale){return ResourceString.hashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context)}/**
+     */},{key:"hashKeyForTranslation",value:function hashKeyForTranslation(locale){return ResourceString.hashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context,this.sourceHash)}/**
      * Return the a hash key that uniquely identifies this resource, but cleaned
      *
      *  @return {String} a unique hash key for this resource, but cleaned
-     */},{key:"cleanHashKey",value:function cleanHashKey(){var locale=this.targetLocale||this.getSourceLocale();return ResourceString.cleanHashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context)}/**
+     */},{key:"cleanHashKey",value:function cleanHashKey(){var locale=this.targetLocale||this.getSourceLocale();return ResourceString.cleanHashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context,this.sourceHash)}/**
      * Return the a hash key that uniquely identifies the translation of
      * this resource to the given locale, but cleaned
      *
      * @param {String} locale a locale spec of the desired translation
      * @return {String} a unique hash key for this resource's string
-     */},{key:"cleanHashKeyForTranslation",value:function cleanHashKeyForTranslation(locale){return ResourceString.cleanHashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context)}/**
+     */},{key:"cleanHashKeyForTranslation",value:function cleanHashKeyForTranslation(locale){return ResourceString.cleanHashKey(this.project,locale,this.reskey,this.datatype,this.flavor,this.context,this.sourceHash)}/**
      * Check if the given resource is an instance of the current
      * resource.
      *
@@ -95,7 +96,7 @@
      * @returns {boolean} true if this is an instance of
      * the current resource, false otherwise.
      */},{key:"isInstance",value:function isInstance(resource){if(!_superPropGet(ResourceString,"isInstance",this,3)([resource])){return false}// now check the properties specific to this resource subclass
-return(0,_utils.cleanString)(this.source)===(0,_utils.cleanString)(resource.source)}}],[{key:"hashKey",value:function hashKey(project,locale,reskey,datatype,flavor,context){var key=["rs",project,locale,reskey,datatype,flavor,context].join("_");logger.trace("Hashkey is "+key);return key}/**
+return(0,_utils.cleanString)(this.source)===(0,_utils.cleanString)(resource.source)}}],[{key:"hashKey",value:function hashKey(project,locale,reskey,datatype,flavor,context,sourceHash){var key=["rs",project,locale,reskey,datatype,flavor,context,sourceHash].join("_");logger.trace("Hashkey is "+key);return key}/**
      * Calculate a resource key string for this class of resource given the
      * parameters.
      *
@@ -105,9 +106,10 @@ return(0,_utils.cleanString)(this.source)===(0,_utils.cleanString)(resource.sour
      * @param {String} datatype the datatype of the string
      * @param {String} flavor the flavor of the string
      * @param {String} context the context of the string
+     * @param {String} sourceHash the sourceHash of the string
      * @static
      * @return {String} a hash key
-     */},{key:"cleanHashKey",value:function cleanHashKey(project,locale,reskey,datatype,flavor,context){var cleaned=reskey&&reskey.replace(/\s+/g," ").trim()||"";var key=["rs",project,locale,cleaned,datatype,flavor,context].join("_");logger.trace("CleanHashkey is "+key);return key}}])}(_Resource2["default"]);/**
+     */},{key:"cleanHashKey",value:function cleanHashKey(project,locale,reskey,datatype,flavor,context,sourceHash){var cleaned=reskey&&reskey.replace(/\s+/g," ").trim()||"";var key=["rs",project,locale,cleaned,datatype,flavor,context,sourceHash].join("_");logger.trace("CleanHashkey is "+key);return key}}])}(_Resource2["default"]);/**
  * The class of this kind of string resource.
  *
  * @static

package/lib/ResourceString.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceString.js","names":["_Resource2","_interopRequireDefault","require","_utils","_log4jsApi","e","__esModule","_classCallCheck","a","n","TypeError","_defineProperties","r","t","length","o","enumerable","configurable","writable","Object","defineProperty","_toPropertyKey","key","_createClass","prototype","i","_toPrimitive","_typeof","Symbol","toPrimitive","call","String","Number","_callSuper","_getPrototypeOf","_possibleConstructorReturn","_isNativeReflectConstruct","Reflect","construct","constructor","apply","_assertThisInitialized","ReferenceError","Boolean","valueOf","_superPropGet","p","_get","get","bind","_superPropBase","getOwnPropertyDescriptor","arguments","value","hasOwnProperty","setPrototypeOf","getPrototypeOf","__proto__","_inherits","create","_setPrototypeOf","logger","log4js","getLogger","ResourceString","_Resource","props","_this","source","text","target","origin","datatype","resType","resClass","sourceLocale","project","setSource","str","dirty","setTarget","size","clone","overrides","equals","other","same","hashKey","locale","targetLocale","getSourceLocale","reskey","flavor","context","hashKeyForTranslation","cleanHashKey","cleanHashKeyForTranslation","isInstance","resource","cleanString","join","trace","cleaned","replace","trim","Resource","_default","exports","module","default"],"sources":["../src/ResourceString.js"],"sourcesContent":["/*\n * ResourceString.js - represents an string in a resource file\n *\n * Copyright © 2022-2023 JEDLSoft\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport Resource from \"./Resource.js\";\nimport { cleanString } from \"./utils.js\";\nimport log4js from \"@log4js-node/log4js-api\";\n\nconst logger = log4js.getLogger(\"tools-common.ResourceString\");\n\n/**\n * Represents a string resource from a resource file or\n * extracted from the code.\n */\nclass ResourceString extends Resource {\n    /**\n     * Construct a new ResourceString instance. The props may contain any\n     * of properties from the Resource constructor and additionally,\n     * these properties:\n     *\n     * <ul>\n     * <li>source {String} - the source string associated with this key\n     * </ul>\n     *\n     * @constructor\n     * @param {Object} props properties of the string, as defined above\n     */\n    constructor(props) {\n        super(props);\n\n        if (props) {\n            this.source = typeof(props.source) === 'string' ? props.source : props.text;\n            this.target = props.target;\n        }\n\n        this.origin = this.origin || \"source\";\n        this.datatype = this.datatype || \"plaintext\";\n        this.resType = ResourceString.resClass;\n        this.sourceLocale = this.sourceLocale || this.project && this.project.sourceLocale || \"en-US\";\n    }\n\n    /**\n     * Set the source string written in the source\n     * locale of this resource string.\n     *\n     * @param {String} str the source string\n     */\n    setSource(str) {\n        if (typeof(str) !== 'string') return;\n        this.source = str;\n        this.dirty = true;\n    }\n\n    /**\n     * Set the target string of this resource.\n     *\n     * @param {String} str the target string\n     */\n    setTarget(str) {\n        if (typeof(str) !== 'string') return;\n        this.target = str;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the number of strings in this resource.\n     *\n     * @returns {number} the number of strings in this resource\n     */\n    size() {\n        return 1;\n    }\n\n    /**\n     * Clone this resource and override the properties with the given ones.\n     *\n     * @params {Object|undefined} overrides optional properties to override in\n     * the cloned object\n     * @returns {ResourceArray} a clone of this resource\n     */\n    clone(overrides) {\n        const r = new ResourceString(this);\n        if (overrides) {\n            for (let p in overrides) {\n                r[p] = overrides[p];\n            }\n        }\n        return r;\n    }\n\n    /**\n     * Return true if the other resource contains the exact same resource as\n     * the current one. All fields must match.\n     *\n     * @param {Resource} other another resource to test against the current one\n     * @returns {boolean} true if these represent the same resource, false otherwise\n     */\n    equals(other) {\n        if (!other || !this.same(other)) return false;\n\n        return this.source === other.source;\n    }\n\n    /**\n     * Calculate a resource key string for this class of resource given the\n     * parameters.\n     *\n     * @param {String} project the project of the string\n     * @param {String} locale the locale of the string\n     * @param {String} reskey the key of the string\n     * @param {String} datatype the datatype of the string\n     * @param {String} flavor the flavor of the string\n     * @param {String} context the context of the string\n     * @static\n     * @return {String} a hash key\n     */\n    static hashKey(project, locale, reskey, datatype, flavor, context) {\n        const key = [\"rs\", project, locale, reskey, datatype, flavor, context].join(\"_\");\n        logger.trace(\"Hashkey is \" + key);\n        return key;\n    }\n\n    /**\n     * Calculate a resource key string for this class of resource given the\n     * parameters.\n     *\n     * @param {String} project the project of the string\n     * @param {String} locale the locale of the string\n     * @param {String} reskey the key of the string\n     * @param {String} datatype the datatype of the string\n     * @param {String} flavor the flavor of the string\n     * @param {String} context the context of the string\n     * @static\n     * @return {String} a hash key\n     */\n    static cleanHashKey(project, locale, reskey, datatype, flavor, context) {\n        const cleaned = reskey && reskey.replace(/\\s+/g, \" \").trim() || \"\";\n        const key = [\"rs\", project, locale, cleaned, datatype, flavor, context].join(\"_\");\n        logger.trace(\"CleanHashkey is \" + key);\n        return key;\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource.\n     *\n     *  @return {String} a unique hash key for this resource\n     */\n    hashKey() {\n        const locale = this.targetLocale || this.getSourceLocale();\n        return ResourceString.hashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context);\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies the translation of\n     * this resource to the given locale.\n     *\n     * @param {String} locale a locale spec of the desired translation\n     * @return {String} a unique hash key for this resource\n     */\n    hashKeyForTranslation(locale) {\n        return ResourceString.hashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context);\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource, but cleaned\n     *\n     *  @return {String} a unique hash key for this resource, but cleaned\n     */\n    cleanHashKey() {\n        const locale = this.targetLocale || this.getSourceLocale();\n        return ResourceString.cleanHashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context);\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies the translation of\n     * this resource to the given locale, but cleaned\n     *\n     * @param {String} locale a locale spec of the desired translation\n     * @return {String} a unique hash key for this resource's string\n     */\n    cleanHashKeyForTranslation(locale) {\n        return ResourceString.cleanHashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context);\n    }\n\n    /**\n     * Check if the given resource is an instance of the current\n     * resource.\n     *\n     * @override\n     * @param {Resource} a resource to check\n     * @returns {boolean} true if this is an instance of\n     * the current resource, false otherwise.\n     */\n    isInstance(resource) {\n        if (!super.isInstance(resource)) {\n            return false;\n        }\n\n        // now check the properties specific to this resource subclass\n        return cleanString(this.source) === cleanString(resource.source);\n    }\n}\n\n/**\n * The class of this kind of string resource.\n *\n * @static\n * @const\n */\nResourceString.resClass = \"string\";\n\n\nexport default ResourceString;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ResourceString.js","names":["_Resource2","_interopRequireDefault","require","_utils","_log4jsApi","e","__esModule","_classCallCheck","a","n","TypeError","_defineProperties","r","t","length","o","enumerable","configurable","writable","Object","defineProperty","_toPropertyKey","key","_createClass","prototype","i","_toPrimitive","_typeof","Symbol","toPrimitive","call","String","Number","_callSuper","_getPrototypeOf","_possibleConstructorReturn","_isNativeReflectConstruct","Reflect","construct","constructor","apply","_assertThisInitialized","ReferenceError","Boolean","valueOf","_superPropGet","p","_get","get","bind","_superPropBase","getOwnPropertyDescriptor","arguments","value","hasOwnProperty","setPrototypeOf","getPrototypeOf","__proto__","_inherits","create","_setPrototypeOf","logger","log4js","getLogger","ResourceString","_Resource","props","_this","source","text","target","origin","datatype","resType","resClass","sourceLocale","project","setSource","str","dirty","setTarget","size","clone","overrides","equals","other","same","hashKey","locale","targetLocale","getSourceLocale","reskey","flavor","context","sourceHash","hashKeyForTranslation","cleanHashKey","cleanHashKeyForTranslation","isInstance","resource","cleanString","join","trace","cleaned","replace","trim","Resource","_default","exports","module","default"],"sources":["../src/ResourceString.js"],"sourcesContent":["/*\n * ResourceString.js - represents an string in a resource file\n *\n * Copyright © 2022-2023, 2026 JEDLSoft\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport Resource from \"./Resource.js\";\nimport { cleanString } from \"./utils.js\";\nimport log4js from \"@log4js-node/log4js-api\";\n\nconst logger = log4js.getLogger(\"tools-common.ResourceString\");\n\n/**\n * Represents a string resource from a resource file or\n * extracted from the code.\n */\nclass ResourceString extends Resource {\n    /**\n     * Construct a new ResourceString instance. The props may contain any\n     * of properties from the Resource constructor and additionally,\n     * these properties:\n     *\n     * <ul>\n     * <li>source {String} - the source string associated with this key\n     * </ul>\n     *\n     * @constructor\n     * @param {Object} props properties of the string, as defined above\n     */\n    constructor(props) {\n        super(props);\n\n        if (props) {\n            this.source = typeof(props.source) === 'string' ? props.source : props.text;\n            this.target = props.target;\n        }\n\n        this.origin = this.origin || \"source\";\n        this.datatype = this.datatype || \"plaintext\";\n        this.resType = ResourceString.resClass;\n        this.sourceLocale = this.sourceLocale || this.project && this.project.sourceLocale || \"en-US\";\n    }\n\n    /**\n     * Set the source string written in the source\n     * locale of this resource string.\n     *\n     * @param {String} str the source string\n     */\n    setSource(str) {\n        if (typeof(str) !== 'string') return;\n        this.source = str;\n        this.dirty = true;\n    }\n\n    /**\n     * Set the target string of this resource.\n     *\n     * @param {String} str the target string\n     */\n    setTarget(str) {\n        if (typeof(str) !== 'string') return;\n        this.target = str;\n        this.dirty = true;\n    }\n\n    /**\n     * Return the number of strings in this resource.\n     *\n     * @returns {number} the number of strings in this resource\n     */\n    size() {\n        return 1;\n    }\n\n    /**\n     * Clone this resource and override the properties with the given ones.\n     *\n     * @params {Object|undefined} overrides optional properties to override in\n     * the cloned object\n     * @returns {ResourceArray} a clone of this resource\n     */\n    clone(overrides) {\n        const r = new ResourceString(this);\n        if (overrides) {\n            for (let p in overrides) {\n                r[p] = overrides[p];\n            }\n        }\n        return r;\n    }\n\n    /**\n     * Return true if the other resource contains the exact same resource as\n     * the current one. All fields must match.\n     *\n     * @param {Resource} other another resource to test against the current one\n     * @returns {boolean} true if these represent the same resource, false otherwise\n     */\n    equals(other) {\n        if (!other || !this.same(other)) return false;\n\n        return this.source === other.source;\n    }\n\n    /**\n     * Calculate a resource key string for this class of resource given the\n     * parameters.\n     *\n     * @param {String} project the project of the string\n     * @param {String} locale the locale of the string\n     * @param {String} reskey the key of the string\n     * @param {String} datatype the datatype of the string\n     * @param {String} flavor the flavor of the string\n     * @param {String} context the context of the string\n     * @param {String} sourceHash the sourceHash of the string\n     * @static\n     * @return {String} a hash key\n     */\n    static hashKey(project, locale, reskey, datatype, flavor, context, sourceHash) {\n        const key = [\"rs\", project, locale, reskey, datatype, flavor, context, sourceHash].join(\"_\");\n        logger.trace(\"Hashkey is \" + key);\n        return key;\n    }\n\n    /**\n     * Calculate a resource key string for this class of resource given the\n     * parameters.\n     *\n     * @param {String} project the project of the string\n     * @param {String} locale the locale of the string\n     * @param {String} reskey the key of the string\n     * @param {String} datatype the datatype of the string\n     * @param {String} flavor the flavor of the string\n     * @param {String} context the context of the string\n     * @param {String} sourceHash the sourceHash of the string\n     * @static\n     * @return {String} a hash key\n     */\n    static cleanHashKey(project, locale, reskey, datatype, flavor, context, sourceHash) {\n        const cleaned = reskey && reskey.replace(/\\s+/g, \" \").trim() || \"\";\n        const key = [\"rs\", project, locale, cleaned, datatype, flavor, context, sourceHash].join(\"_\");\n        logger.trace(\"CleanHashkey is \" + key);\n        return key;\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource.\n     *\n     *  @return {String} a unique hash key for this resource\n     */\n    hashKey() {\n        const locale = this.targetLocale || this.getSourceLocale();\n        return ResourceString.hashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context, this.sourceHash);\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies the translation of\n     * this resource to the given locale.\n     *\n     * @param {String} locale a locale spec of the desired translation\n     * @return {String} a unique hash key for this resource\n     */\n    hashKeyForTranslation(locale) {\n        return ResourceString.hashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context, this.sourceHash);\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies this resource, but cleaned\n     *\n     *  @return {String} a unique hash key for this resource, but cleaned\n     */\n    cleanHashKey() {\n        const locale = this.targetLocale || this.getSourceLocale();\n        return ResourceString.cleanHashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context, this.sourceHash);\n    }\n\n    /**\n     * Return the a hash key that uniquely identifies the translation of\n     * this resource to the given locale, but cleaned\n     *\n     * @param {String} locale a locale spec of the desired translation\n     * @return {String} a unique hash key for this resource's string\n     */\n    cleanHashKeyForTranslation(locale) {\n        return ResourceString.cleanHashKey(this.project, locale, this.reskey, this.datatype, this.flavor, this.context, this.sourceHash);\n    }\n\n    /**\n     * Check if the given resource is an instance of the current\n     * resource.\n     *\n     * @override\n     * @param {Resource} a resource to check\n     * @returns {boolean} true if this is an instance of\n     * the current resource, false otherwise.\n     */\n    isInstance(resource) {\n        if (!super.isInstance(resource)) {\n            return false;\n        }\n\n        // now check the properties specific to this resource subclass\n        return cleanString(this.source) === cleanString(resource.source);\n    }\n}\n\n/**\n * The class of this kind of string resource.\n *\n * @static\n * @const\n */\nResourceString.resClass = \"string\";\n\n\nexport default ResourceString;\n"],"mappings":"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","ignoreList":[]}

package/lib/ResourceXliff.js

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports["default"]=void 0;var _ilibXliff=require("ilib-xliff");var _log4jsApi=_interopRequireDefault(require("@log4js-node/log4js-api"));var _ResourceString=_interopRequireDefault(require("./ResourceString.js"));var _ResourceArray=_interopRequireDefault(require("./ResourceArray.js"));var _ResourcePlural=_interopRequireDefault(require("./ResourcePlural.js"));var _TranslationSet=_interopRequireDefault(require("./TranslationSet.js"));var _Location=_interopRequireDefault(require("./Location.js"));var _utils=require("./utils.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{"default":e}}function _typeof(o){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(o){return typeof o}:function(o){return o&&"function"==typeof Symbol&&o.constructor===Symbol&&o!==Symbol.prototype?"symbol":typeof o},_typeof(o)}function _classCallCheck(a,n){if(!(a instanceof n))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,r){for(var t=0;t<r.length;t++){var o=r[t];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,_toPropertyKey(o.key),o)}}function _createClass(e,r,t){return r&&_defineProperties(e.prototype,r),t&&_defineProperties(e,t),Object.defineProperty(e,"prototype",{writable:!1}),e}function _toPropertyKey(t){var i=_toPrimitive(t,"string");return"symbol"==_typeof(i)?i:i+""}function _toPrimitive(t,r){if("object"!=_typeof(t)||!t)return t;var e=t[Symbol.toPrimitive];if(void 0!==e){var i=e.call(t,r||"default");if("object"!=_typeof(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}/*
- * Xliff.js - convert an Xliff file into a set of resources and vice versa
+ * ResourceXliff.js - convert an ResourceXliff file into a set of resources and vice versa
  *
- * Copyright © 2022-2023, 2025 JEDLSoft
+ * Copyright © 2022-2023, 2025-2026 JEDLSoft
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -42,21 +42,21 @@ return res.comment}}json.pluralForm=form;json.pluralFormOther=res.getKey();retur
      * @param {string} [options.version] The version of xliff that will be produced by this instance. This
      * may be either "1.2" or "2.0"
      * @param {Xliff} [options.xliff] The xliff instance to use for this resource xliff instance.
-    */function ResourceXliff(options){var _options$xliff;_classCallCheck(this,ResourceXliff);if(options){this["tool-id"]=options["tool-id"];this["tool-name"]=options["tool-name"];this["tool-version"]=options["tool-version"];this["tool-company"]=options["tool-company"];this.copyright=options.copyright;this.path=options.path;this.sourceLocale=options.sourceLocale||"en-US";this.project=options.project;this.allowDups=options.allowDups;this.style=options.style||"standard";if(typeof options.version!=="undefined"){this.version=options.version}}this.sourceLocale=this.sourceLocale||"en-US";this.xliff=(_options$xliff=options===null||options===void 0?void 0:options.xliff)!==null&&_options$xliff!==void 0?_options$xliff:new _ilibXliff.Xliff(options);this.ts=new _TranslationSet["default"](this.sourceLocale)}/**
+    */function ResourceXliff(options){var _options$xliff,_this=this;_classCallCheck(this,ResourceXliff);if(options){this["tool-id"]=options["tool-id"];this["tool-name"]=options["tool-name"];this["tool-version"]=options["tool-version"];this["tool-company"]=options["tool-company"];this.copyright=options.copyright;this.path=options.path;this.sourceLocale=options.sourceLocale||"en-US";this.project=options.project;this.allowDups=options.allowDups;this.style=options.style||"standard";if(typeof options.version!=="undefined"){this.version=options.version}}this.sourceLocale=this.sourceLocale||"en-US";this.xliff=(_options$xliff=options===null||options===void 0?void 0:options.xliff)!==null&&_options$xliff!==void 0?_options$xliff:new _ilibXliff.Xliff(options);this.ts=new _TranslationSet["default"](this.sourceLocale);if(this.xliff.getTranslationUnits().length){var translationUnits=this.xliff.getTranslationUnits();translationUnits.forEach(function(tu){_this.ts.add(_this.convertTransUnit(tu))})}}/**
      * Convert a resource into one or more translation units.
      *
      * @private
      * @param {Resource} res the resource to convert
      * @returns {Array.<TranslationUnit>} an array of translation units
      * that represent the resource
-     */return _createClass(ResourceXliff,[{key:"convertResource",value:function convertResource(res){var units=[],tu;try{switch(res.resType){case"string":tu=new _ilibXliff.TranslationUnit({project:res.project,key:res.getKey(),file:res.getPath(),sourceLocale:res.getSourceLocale(),source:res.getSource(),targetLocale:res.getTargetLocale(),target:res.getTarget(),state:res.getState(),id:res.getId(),translated:true,context:res.context,comment:res.comment,resType:res.resType,datatype:res.datatype,flavor:res.getFlavor?res.getFlavor():undefined,translate:!res.getDNT(),location:res.getLocation()});units.push(tu);break;case"array":var sarr=res.getSource();var tarr=res.getTarget();tu=new _ilibXliff.TranslationUnit({project:res.project,key:res.getKey(),file:res.getPath(),source:" ",sourceLocale:res.getSourceLocale(),targetLocale:res.getTargetLocale(),state:res.getState(),id:res.getId(),translated:true,context:res.context,comment:res.comment,resType:res.resType,datatype:res.datatype,flavor:res.getFlavor?res.getFlavor():undefined,translate:!res.getDNT(),location:res.getLocation()});for(var j=0;j<sarr.length;j++){// only output array items that have a translation
-if(sarr[j]){var newtu=tu.clone();newtu.source=sarr[j];newtu.ordinal=j;if(tarr&&j<tarr.length&&tarr[j]){newtu.target=tarr[j]}newtu.ordinal=j;units.push(newtu)}else if(tarr[j]){logger.warn("Translated array  "+res.getKey()+" has no source string at index "+j+". Cannot translate. Resource is: "+JSON.stringify(res,undefined,4))}}break;case"plural":tu=new _ilibXliff.TranslationUnit({project:res.project,key:res.getKey(),file:res.getPath(),source:" ",sourceLocale:res.getSourceLocale(),targetLocale:res.getTargetLocale(),state:res.getState(),id:res.getId(),translated:true,context:res.context,resType:res.resType,datatype:res.datatype,flavor:res.getFlavor?res.getFlavor():undefined,location:res.getLocation(),translate:!res.getDNT()});var sp=res.getSource();var tp=res.getTarget();if(!tp||(0,_utils.isEmpty)(tp)){for(var p in sp){var _newtu=tu.clone();_newtu.source=sp[p];_newtu.quantity=p;_newtu.comment=generatePluralComment(res,sp,p);units.push(_newtu)}}else{for(var _p in tp){var _newtu2=tu.clone();_newtu2.source=sp[_p]||sp.other;_newtu2.target=tp[_p];_newtu2.quantity=_p;_newtu2.comment=generatePluralComment(res,sp,_p);units.push(_newtu2)}}break}}catch(e){logger.warn(e);logger.warn(JSON.stringify(res));logger.warn("Skipping that resource.")}return units}/**
+     */return _createClass(ResourceXliff,[{key:"convertResource",value:function convertResource(res){var units=[],tu;try{switch(res.resType){case"string":tu=new _ilibXliff.TranslationUnit({project:res.project,key:res.getKey(),file:res.getPath(),sourceLocale:res.getSourceLocale(),source:res.getSource(),targetLocale:res.getTargetLocale(),target:res.getTarget(),state:res.getState(),id:res.getId(),translated:true,context:res.context,comment:res.comment,resType:res.resType,datatype:res.datatype,flavor:res.getFlavor?res.getFlavor():undefined,translate:!res.getDNT(),location:res.getLocation(),metadata:res.metadata,autoKey:res.getAutoKey()});units.push(tu);break;case"array":var sarr=res.getSource();var tarr=res.getTarget();tu=new _ilibXliff.TranslationUnit({project:res.project,key:res.getKey(),file:res.getPath(),source:" ",sourceLocale:res.getSourceLocale(),targetLocale:res.getTargetLocale(),state:res.getState(),id:res.getId(),translated:true,context:res.context,comment:res.comment,resType:res.resType,datatype:res.datatype,flavor:res.getFlavor?res.getFlavor():undefined,translate:!res.getDNT(),location:res.getLocation(),autoKey:res.getAutoKey()});for(var j=0;j<sarr.length;j++){// only output array items that have a translation
+if(sarr[j]){var newtu=tu.clone();newtu.source=sarr[j];newtu.ordinal=j;if(tarr&&j<tarr.length&&tarr[j]){newtu.target=tarr[j]}newtu.ordinal=j;units.push(newtu)}else if(tarr[j]){logger.warn("Translated array  "+res.getKey()+" has no source string at index "+j+". Cannot translate. Resource is: "+JSON.stringify(res,undefined,4))}}break;case"plural":tu=new _ilibXliff.TranslationUnit({project:res.project,key:res.getKey(),file:res.getPath(),source:" ",sourceLocale:res.getSourceLocale(),targetLocale:res.getTargetLocale(),state:res.getState(),id:res.getId(),translated:true,context:res.context,resType:res.resType,datatype:res.datatype,flavor:res.getFlavor?res.getFlavor():undefined,location:res.getLocation(),translate:!res.getDNT(),autoKey:res.getAutoKey()});var sp=res.getSource();var tp=res.getTarget();if(!tp||(0,_utils.isEmpty)(tp)){for(var p in sp){var _newtu=tu.clone();_newtu.source=sp[p];_newtu.quantity=p;_newtu.comment=generatePluralComment(res,sp,p);units.push(_newtu)}}else{for(var _p in tp){var _newtu2=tu.clone();_newtu2.source=sp[_p]||sp.other;_newtu2.target=tp[_p];_newtu2.quantity=_p;_newtu2.comment=generatePluralComment(res,sp,_p);units.push(_newtu2)}}break}}catch(e){logger.warn(e);logger.warn(JSON.stringify(res));logger.warn("Skipping that resource.")}return units}/**
      * Convert a translation unit to a new loctool resource.
      *
      * @private
      * @param {TranslationUnit} tu the translation to convert
      * @return {Resource} the corresponding resource
-     */},{key:"convertTransUnit",value:function convertTransUnit(tu){var res;switch(tu.resType){default:res=new _ResourceString["default"]({pathName:tu.file,project:tu.project,id:tu.id,key:tu.key,sourceLocale:tu.sourceLocale,source:tu.source,targetLocale:tu.targetLocale,context:tu.context,comment:tu.comment,resType:tu.resType,datatype:tu.datatype,state:tu.state,flavor:tu.flavor,location:new _Location["default"](tu.location),resfile:tu.resfile});if(tu.target){res.setTarget(tu.target)}break;case"array":var arr=[];arr[tu.ordinal]=tu.source;res=new _ResourceArray["default"]({pathName:tu.file,project:tu.project,id:tu.id,key:tu.key,sourceLocale:tu.sourceLocale,source:arr,targetLocale:tu.targetLocale,target:[],context:tu.context,comment:tu.comment,resType:tu.resType,datatype:tu.datatype,state:tu.state,flavor:tu.flavor,location:new _Location["default"](tu.location),resfile:tu.resfile});if(tu.target){res.addTargetItem(tu.ordinal,tu.target)}break;case"plural":var strings={};strings[tu.quantity]=tu.source;res=new _ResourcePlural["default"]({pathName:tu.file,project:tu.project,id:tu.id,key:tu.key,sourceLocale:tu.sourceLocale,source:strings,targetLocale:tu.targetLocale,target:{},context:tu.context,comment:tu.comment,resType:tu.resType,datatype:tu.datatype,state:tu.state,flavor:tu.flavor,location:new _Location["default"](tu.location),resfile:tu.resfile});if(tu.target){res.addTargetPlural(tu.quantity,tu.target)}break}if(typeof tu.translate==="boolean"){res.setDNT(!tu.translate)}return res}},{key:"getPath",value:function getPath(){return this.path}},{key:"setPath",value:function setPath(newPath){this.path=newPath}/**
+     */},{key:"convertTransUnit",value:function convertTransUnit(tu){var res;switch(tu.resType){default:res=new _ResourceString["default"]({pathName:tu.file,project:tu.project,id:tu.id,key:tu.key,sourceLocale:tu.sourceLocale,source:tu.source,targetLocale:tu.targetLocale,context:tu.context,comment:tu.comment,resType:tu.resType,datatype:tu.datatype,state:tu.state,flavor:tu.flavor,location:new _Location["default"](tu.location),resfile:tu.resfile,metadata:tu.metadata,sourceHash:tu.sourceHash,autoKey:tu.autoKey});if(tu.target){res.setTarget(tu.target)}break;case"array":var arr=[];arr[tu.ordinal]=tu.source;res=new _ResourceArray["default"]({pathName:tu.file,project:tu.project,id:tu.id,key:tu.key,sourceLocale:tu.sourceLocale,source:arr,targetLocale:tu.targetLocale,target:[],context:tu.context,comment:tu.comment,resType:tu.resType,datatype:tu.datatype,state:tu.state,flavor:tu.flavor,location:new _Location["default"](tu.location),resfile:tu.resfile});if(tu.target){res.addTargetItem(tu.ordinal,tu.target)}break;case"plural":var strings={};strings[tu.quantity]=tu.source;res=new _ResourcePlural["default"]({pathName:tu.file,project:tu.project,id:tu.id,key:tu.key,sourceLocale:tu.sourceLocale,source:strings,targetLocale:tu.targetLocale,target:{},context:tu.context,comment:tu.comment,resType:tu.resType,datatype:tu.datatype,state:tu.state,flavor:tu.flavor,location:new _Location["default"](tu.location),resfile:tu.resfile});if(tu.target){res.addTargetPlural(tu.quantity,tu.target)}break}if(typeof tu.translate==="boolean"){res.setDNT(!tu.translate)}return res}},{key:"getPath",value:function getPath(){return this.path}},{key:"setPath",value:function setPath(newPath){this.path=newPath}/**
      * Parse the given xml and convert it into a set of resources.
      *
      * @param {string} xml the contents of the xliff file to parse