properties-file 2.1.1 → 2.1.4

package/lib/property-line.js

@@ -1,48 +1,48 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PropertyLine = void 0;
-/**
- * Object representing a line from the content of .properties file.
- */
-var PropertyLine = /** @class */ (function () {
-    /**
-     * Create a new line object.
-     *
-     * @param line - The raw content of a line.
-     * @param isMultiline - Is the line spreading on multiple lines?
-     */
-    function PropertyLine(line, isMultiline) {
-        /** True if the line continues, otherwise false. */
-        this.continues = false;
-        /** True if the line is blank, otherwise false. */
-        this.isBlank = false;
-        /** True if the line is a comment, otherwise false. */
-        this.isComment = false;
-        this.content = line.trimStart();
-        this.isMultiline = isMultiline;
-        if (this.content.length === 0) {
-            // Line is blank.
-            this.isBlank = true;
-        }
-        else {
-            if (!this.isMultiline) {
-                // Line is a comment.
-                this.isComment = !!/^[!#]/.test(this.content);
-            }
-            if (!this.isComment) {
-                // Otherwise, check if the line continues on the next line.
-                var backslashMatch = this.content.match(/(?<backslashes>\\+)$/);
-                if (backslashMatch === null || backslashMatch === void 0 ? void 0 : backslashMatch.groups) {
-                    // If the number of backslashes is odd, the line continues, otherwise it doesn't.
-                    this.continues = !!(backslashMatch.groups.backslashes.length % 2);
-                    if (this.continues) {
-                        // Remove the trailing slash so that we can concatenate the line with the next one.
-                        this.content = this.content.slice(0, -1);
-                    }
-                }
-            }
-        }
-    }
-    return PropertyLine;
-}());
-exports.PropertyLine = PropertyLine;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyLine = void 0;
+/**
+ * Object representing a line from the content of .properties file.
+ */
+var PropertyLine = /** @class */ (function () {
+    /**
+     * Create a new line object.
+     *
+     * @param line - The raw content of a line.
+     * @param isMultiline - Is the line spreading on multiple lines?
+     */
+    function PropertyLine(line, isMultiline) {
+        /** True if the line continues, otherwise false. */
+        this.continues = false;
+        /** True if the line is blank, otherwise false. */
+        this.isBlank = false;
+        /** True if the line is a comment, otherwise false. */
+        this.isComment = false;
+        this.content = line.trimStart();
+        this.isMultiline = isMultiline;
+        if (this.content.length === 0) {
+            // Line is blank.
+            this.isBlank = true;
+        }
+        else {
+            if (!this.isMultiline) {
+                // Line is a comment.
+                this.isComment = !!/^[!#]/.test(this.content);
+            }
+            if (!this.isComment) {
+                // Otherwise, check if the line continues on the next line.
+                var backslashMatch = this.content.match(/(?<backslashes>\\+)$/);
+                if (backslashMatch === null || backslashMatch === void 0 ? void 0 : backslashMatch.groups) {
+                    // If the number of backslashes is odd, the line continues, otherwise it doesn't.
+                    this.continues = !!(backslashMatch.groups.backslashes.length % 2);
+                    if (this.continues) {
+                        // Remove the trailing slash so that we can concatenate the line with the next one.
+                        this.content = this.content.slice(0, -1);
+                    }
+                }
+            }
+        }
+    }
+    return PropertyLine;
+}());
+exports.PropertyLine = PropertyLine;

package/lib/property.d.ts

@@ -1,64 +1,64 @@
-import { PropertyLine } from './property-line';
-/**
- * Object representing a property (key/value).
- */
-export declare class Property {
-    /** The length of the delimiter, including its whitespace characters. */
-    delimiterLength: number | undefined;
-    /** The starting position of the delimiter separating the key from the value. */
-    delimiterPosition: number | undefined;
-    /** The property key, including its escaped characters. */
-    escapedKey: string;
-    /** The property value, including its escaped characters. */
-    escapedValue: string;
-    /** Was the property's key used more than once? */
-    hasKeyCollisions: boolean;
-    /** The property key (unescaped). */
-    key: string;
-    /** Starting line numbers of property objects with the same key. */
-    keyCollisionLines: number[];
-    /** The content of one or multiple lines when applicable. */
-    linesContent: string;
-    /** Positions of the newline characters if any. */
-    newlinePositions: number[];
-    /** The line number at which the property starts. */
-    startingLineNumber: number;
-    /** The property value (unescaped). */
-    value: string;
-    /** Does the key definition spread across multiple lines? */
-    private hasMultilineKey;
-    /** Is the key empty? */
-    private hasNoKey;
-    /** Is the value empty? */
-    private hasNoValue;
-    /**
-     * Create a new property object.
-     *
-     * @param propertyLine - A property line object.
-     * @param startingLineNumber - The line number at which the property starts.
-     */
-    constructor(propertyLine: PropertyLine, startingLineNumber: number);
-    /**
-     * Add the a line to a multiline property object.
-     *
-     * @param propertyLine - A property line object.
-     */
-    addLine(propertyLine: PropertyLine): void;
-    /**
-     * Set the property's key and value.
-     */
-    setKeyAndValue(): void;
-    /**
-     * Unescape the content from either key or value of a property.
-     *
-     * @param escapedContent - The content to unescape.
-     * @param startingLineNumber - The starting line number of the content being unescaped.
-     *
-     * @returns The unescaped content.
-     */
-    unescape(escapedContent: string, startingLineNumber: number): string;
-    /**
-     * Find the delimiting characters separating the key from the value.
-     */
-    private findDelimiter;
-}
+import { PropertyLine } from './property-line';
+/**
+ * Object representing a property (key/value).
+ */
+export declare class Property {
+    /** The length of the delimiter, including its whitespace characters. */
+    delimiterLength: number | undefined;
+    /** The starting position of the delimiter separating the key from the value. */
+    delimiterPosition: number | undefined;
+    /** The property key, including its escaped characters. */
+    escapedKey: string;
+    /** The property value, including its escaped characters. */
+    escapedValue: string;
+    /** Was the property's key used more than once? */
+    hasKeyCollisions: boolean;
+    /** The property key (unescaped). */
+    key: string;
+    /** Starting line numbers of property objects with the same key. */
+    keyCollisionLines: number[];
+    /** The content of one or multiple lines when applicable. */
+    linesContent: string;
+    /** Positions of the newline characters if any. */
+    newlinePositions: number[];
+    /** The line number at which the property starts. */
+    startingLineNumber: number;
+    /** The property value (unescaped). */
+    value: string;
+    /** Does the key definition spread across multiple lines? */
+    private hasMultilineKey;
+    /** Is the key empty? */
+    private hasNoKey;
+    /** Is the value empty? */
+    private hasNoValue;
+    /**
+     * Create a new property object.
+     *
+     * @param propertyLine - A property line object.
+     * @param startingLineNumber - The line number at which the property starts.
+     */
+    constructor(propertyLine: PropertyLine, startingLineNumber: number);
+    /**
+     * Add the a line to a multiline property object.
+     *
+     * @param propertyLine - A property line object.
+     */
+    addLine(propertyLine: PropertyLine): void;
+    /**
+     * Set the property's key and value.
+     */
+    setKeyAndValue(): void;
+    /**
+     * Unescape the content from either key or value of a property.
+     *
+     * @param escapedContent - The content to unescape.
+     * @param startingLineNumber - The starting line number of the content being unescaped.
+     *
+     * @returns The unescaped content.
+     */
+    unescape(escapedContent: string, startingLineNumber: number): string;
+    /**
+     * Find the delimiting characters separating the key from the value.
+     */
+    private findDelimiter;
+}

package/lib/property.js

@@ -1,205 +1,205 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Property = void 0;
-/**
- * Object representing a property (key/value).
- */
-var Property = /** @class */ (function () {
-    /**
-     * Create a new property object.
-     *
-     * @param propertyLine - A property line object.
-     * @param startingLineNumber - The line number at which the property starts.
-     */
-    function Property(propertyLine, startingLineNumber) {
-        /** The property key, including its escaped characters. */
-        this.escapedKey = '';
-        /** The property value, including its escaped characters. */
-        this.escapedValue = '';
-        /** Was the property's key used more than once? */
-        this.hasKeyCollisions = false;
-        /** The property key (unescaped). */
-        this.key = '';
-        /** Starting line numbers of property objects with the same key. */
-        this.keyCollisionLines = [];
-        /** Positions of the newline characters if any. */
-        this.newlinePositions = [];
-        /** The property value (unescaped). */
-        this.value = '';
-        /** Does the key definition spread across multiple lines? */
-        this.hasMultilineKey = false;
-        /** Is the key empty? */
-        this.hasNoKey = false;
-        /** Is the value empty? */
-        this.hasNoValue = false;
-        this.linesContent = propertyLine.content;
-        this.startingLineNumber = startingLineNumber;
-    }
-    /**
-     * Add the a line to a multiline property object.
-     *
-     * @param propertyLine - A property line object.
-     */
-    Property.prototype.addLine = function (propertyLine) {
-        if (this.linesContent.length > 0) {
-            this.newlinePositions.push(this.linesContent.length);
-        }
-        this.linesContent += propertyLine.content;
-    };
-    /**
-     * Set the property's key and value.
-     */
-    Property.prototype.setKeyAndValue = function () {
-        this.findDelimiter();
-        if (this.delimiterPosition !== undefined && this.delimiterLength !== undefined) {
-            // Set key if present.
-            if (!this.hasNoKey) {
-                this.escapedKey = this.linesContent.slice(0, this.delimiterPosition);
-                this.key = this.unescape(this.escapedKey, this.startingLineNumber);
-            }
-            // Set value if present.
-            if (!this.hasNoValue) {
-                this.escapedValue = this.linesContent.slice(this.delimiterPosition + this.delimiterLength);
-                this.value = this.unescape(this.escapedValue, this.startingLineNumber);
-            }
-        }
-        else if (this.hasNoValue) {
-            // Set key if present (no delimiter).
-            this.escapedKey = this.linesContent;
-            this.key = this.unescape(this.escapedKey, this.startingLineNumber);
-        }
-    };
-    /**
-     * Unescape the content from either key or value of a property.
-     *
-     * @param escapedContent - The content to unescape.
-     * @param startingLineNumber - The starting line number of the content being unescaped.
-     *
-     * @returns The unescaped content.
-     */
-    Property.prototype.unescape = function (escapedContent, startingLineNumber) {
-        var unescapedContent = '';
-        for (var character = escapedContent[0], position = 0; position < escapedContent.length; position++, character = escapedContent[position]) {
-            if (character === '\\') {
-                var nextCharacter = escapedContent[position + 1];
-                switch (nextCharacter) {
-                    case 'f': {
-                        // Formfeed/
-                        unescapedContent += '\f';
-                        position++;
-                        break;
-                    }
-                    case 'n': {
-                        // Newline.
-                        unescapedContent += '\n';
-                        position++;
-                        break;
-                    }
-                    case 'r': {
-                        // Carriage return.
-                        unescapedContent += '\r';
-                        position++;
-                        break;
-                    }
-                    case 't': {
-                        // Tab.
-                        unescapedContent += '\t';
-                        position++;
-                        break;
-                    }
-                    case 'u': {
-                        // Unicode character.
-                        var codePoint = escapedContent.slice(position + 2, position + 6);
-                        if (!/[\da-f]{4}/i.test(codePoint)) {
-                            // Code point can only be within Unicode's Multilingual Plane (BMP).
-                            throw new Error("malformed escaped unicode characters '\\u".concat(codePoint, "' in property starting at line ").concat(startingLineNumber));
-                        }
-                        unescapedContent += String.fromCodePoint(Number.parseInt(codePoint, 16));
-                        position += 5;
-                        break;
-                    }
-                    default: {
-                        // Otherwise the escape character is not required.
-                        unescapedContent += nextCharacter;
-                        position++;
-                    }
-                }
-            }
-            else {
-                // When there is \, simply add the character.
-                unescapedContent += character;
-            }
-        }
-        return unescapedContent;
-    };
-    /**
-     * Find the delimiting characters separating the key from the value.
-     */
-    Property.prototype.findDelimiter = function () {
-        var _a, _b;
-        // If the delimiter was already found, skip.
-        if (this.hasNoKey || this.hasNoValue || this.delimiterPosition) {
-            return;
-        }
-        for (var character = this.linesContent[0], position = 0; position < this.linesContent.length; position++, character = this.linesContent[position]) {
-            // If the character is not a delimiter, check the next one.
-            if (!/[\t\f :=]/.test(character)) {
-                continue;
-            }
-            // Check if the delimiter might be escaped.
-            var prefix = !position ? '' : this.linesContent.slice(0, position);
-            if (prefix.length > 0) {
-                var backslashMatch = prefix.match(/(?<backslashes>\\+)$/);
-                if (backslashMatch === null || backslashMatch === void 0 ? void 0 : backslashMatch.groups) {
-                    var delimiterIsEscaped = !!(backslashMatch.groups.backslashes.length % 2);
-                    if (delimiterIsEscaped) {
-                        // If the delimiter is escaped, check the next character.
-                        continue;
-                    }
-                }
-            }
-            var delimiter = '';
-            this.delimiterPosition = position;
-            this.hasMultilineKey = !!(this.newlinePositions.length > 0 && this.newlinePositions[0] > position);
-            // Check if the delimiter starts with a whitespace.
-            var nextContent = this.linesContent.slice(position);
-            var leadingWhitespaceMatch = nextContent.match(/^(?<whitespace>\s+)/);
-            var leadingWhitespace = ((_a = leadingWhitespaceMatch === null || leadingWhitespaceMatch === void 0 ? void 0 : leadingWhitespaceMatch.groups) === null || _a === void 0 ? void 0 : _a.whitespace) || '';
-            // If there is a whitespace, move to the next character.
-            if (leadingWhitespace.length > 0) {
-                delimiter += leadingWhitespace;
-                nextContent = nextContent.slice(leadingWhitespace.length);
-            }
-            // Check if there is an equal or colon character.
-            if (/[:=]/.test(nextContent[0])) {
-                delimiter += nextContent[0];
-                nextContent = nextContent.slice(1);
-                // If an equal or colon character was found, try to get trailing whitespace.
-                var trailingWhitespaceMatch = nextContent.match(/^(?<whitespace>\s+)/);
-                var trailingWhitespace = ((_b = trailingWhitespaceMatch === null || trailingWhitespaceMatch === void 0 ? void 0 : trailingWhitespaceMatch.groups) === null || _b === void 0 ? void 0 : _b.whitespace) || '';
-                delimiter += trailingWhitespace;
-            }
-            this.delimiterLength = delimiter.length;
-            // If the line starts with a delimiter, the property has no key.
-            if (!position) {
-                this.hasNoKey = true;
-            }
-            break;
-        }
-        // If there was no delimiter found, the property has no value.
-        if (this.delimiterPosition === undefined) {
-            this.hasNoValue = true;
-        }
-        else {
-            // If the delimiter is after the first newline, mark the key as multiline.
-            if (this.newlinePositions.length > 0) {
-                var firstLinePosition = this.newlinePositions[0];
-                if (firstLinePosition > this.delimiterPosition) {
-                    this.hasMultilineKey = true;
-                }
-            }
-        }
-    };
-    return Property;
-}());
-exports.Property = Property;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Property = void 0;
+/**
+ * Object representing a property (key/value).
+ */
+var Property = /** @class */ (function () {
+    /**
+     * Create a new property object.
+     *
+     * @param propertyLine - A property line object.
+     * @param startingLineNumber - The line number at which the property starts.
+     */
+    function Property(propertyLine, startingLineNumber) {
+        /** The property key, including its escaped characters. */
+        this.escapedKey = '';
+        /** The property value, including its escaped characters. */
+        this.escapedValue = '';
+        /** Was the property's key used more than once? */
+        this.hasKeyCollisions = false;
+        /** The property key (unescaped). */
+        this.key = '';
+        /** Starting line numbers of property objects with the same key. */
+        this.keyCollisionLines = [];
+        /** Positions of the newline characters if any. */
+        this.newlinePositions = [];
+        /** The property value (unescaped). */
+        this.value = '';
+        /** Does the key definition spread across multiple lines? */
+        this.hasMultilineKey = false;
+        /** Is the key empty? */
+        this.hasNoKey = false;
+        /** Is the value empty? */
+        this.hasNoValue = false;
+        this.linesContent = propertyLine.content;
+        this.startingLineNumber = startingLineNumber;
+    }
+    /**
+     * Add the a line to a multiline property object.
+     *
+     * @param propertyLine - A property line object.
+     */
+    Property.prototype.addLine = function (propertyLine) {
+        if (this.linesContent.length > 0) {
+            this.newlinePositions.push(this.linesContent.length);
+        }
+        this.linesContent += propertyLine.content;
+    };
+    /**
+     * Set the property's key and value.
+     */
+    Property.prototype.setKeyAndValue = function () {
+        this.findDelimiter();
+        if (this.delimiterPosition !== undefined && this.delimiterLength !== undefined) {
+            // Set key if present.
+            if (!this.hasNoKey) {
+                this.escapedKey = this.linesContent.slice(0, this.delimiterPosition);
+                this.key = this.unescape(this.escapedKey, this.startingLineNumber);
+            }
+            // Set value if present.
+            if (!this.hasNoValue) {
+                this.escapedValue = this.linesContent.slice(this.delimiterPosition + this.delimiterLength);
+                this.value = this.unescape(this.escapedValue, this.startingLineNumber);
+            }
+        }
+        else if (this.hasNoValue) {
+            // Set key if present (no delimiter).
+            this.escapedKey = this.linesContent;
+            this.key = this.unescape(this.escapedKey, this.startingLineNumber);
+        }
+    };
+    /**
+     * Unescape the content from either key or value of a property.
+     *
+     * @param escapedContent - The content to unescape.
+     * @param startingLineNumber - The starting line number of the content being unescaped.
+     *
+     * @returns The unescaped content.
+     */
+    Property.prototype.unescape = function (escapedContent, startingLineNumber) {
+        var unescapedContent = '';
+        for (var character = escapedContent[0], position = 0; position < escapedContent.length; position++, character = escapedContent[position]) {
+            if (character === '\\') {
+                var nextCharacter = escapedContent[position + 1];
+                switch (nextCharacter) {
+                    case 'f': {
+                        // Formfeed/
+                        unescapedContent += '\f';
+                        position++;
+                        break;
+                    }
+                    case 'n': {
+                        // Newline.
+                        unescapedContent += '\n';
+                        position++;
+                        break;
+                    }
+                    case 'r': {
+                        // Carriage return.
+                        unescapedContent += '\r';
+                        position++;
+                        break;
+                    }
+                    case 't': {
+                        // Tab.
+                        unescapedContent += '\t';
+                        position++;
+                        break;
+                    }
+                    case 'u': {
+                        // Unicode character.
+                        var codePoint = escapedContent.slice(position + 2, position + 6);
+                        if (!/[\da-f]{4}/i.test(codePoint)) {
+                            // Code point can only be within Unicode's Multilingual Plane (BMP).
+                            throw new Error("malformed escaped unicode characters '\\u".concat(codePoint, "' in property starting at line ").concat(startingLineNumber));
+                        }
+                        unescapedContent += String.fromCodePoint(Number.parseInt(codePoint, 16));
+                        position += 5;
+                        break;
+                    }
+                    default: {
+                        // Otherwise the escape character is not required.
+                        unescapedContent += nextCharacter;
+                        position++;
+                    }
+                }
+            }
+            else {
+                // When there is \, simply add the character.
+                unescapedContent += character;
+            }
+        }
+        return unescapedContent;
+    };
+    /**
+     * Find the delimiting characters separating the key from the value.
+     */
+    Property.prototype.findDelimiter = function () {
+        var _a, _b;
+        // If the delimiter was already found, skip.
+        if (this.hasNoKey || this.hasNoValue || this.delimiterPosition) {
+            return;
+        }
+        for (var character = this.linesContent[0], position = 0; position < this.linesContent.length; position++, character = this.linesContent[position]) {
+            // If the character is not a delimiter, check the next one.
+            if (!/[\t\f :=]/.test(character)) {
+                continue;
+            }
+            // Check if the delimiter might be escaped.
+            var prefix = !position ? '' : this.linesContent.slice(0, position);
+            if (prefix.length > 0) {
+                var backslashMatch = prefix.match(/(?<backslashes>\\+)$/);
+                if (backslashMatch === null || backslashMatch === void 0 ? void 0 : backslashMatch.groups) {
+                    var delimiterIsEscaped = !!(backslashMatch.groups.backslashes.length % 2);
+                    if (delimiterIsEscaped) {
+                        // If the delimiter is escaped, check the next character.
+                        continue;
+                    }
+                }
+            }
+            var delimiter = '';
+            this.delimiterPosition = position;
+            this.hasMultilineKey = !!(this.newlinePositions.length > 0 && this.newlinePositions[0] > position);
+            // Check if the delimiter starts with a whitespace.
+            var nextContent = this.linesContent.slice(position);
+            var leadingWhitespaceMatch = nextContent.match(/^(?<whitespace>\s+)/);
+            var leadingWhitespace = ((_a = leadingWhitespaceMatch === null || leadingWhitespaceMatch === void 0 ? void 0 : leadingWhitespaceMatch.groups) === null || _a === void 0 ? void 0 : _a.whitespace) || '';
+            // If there is a whitespace, move to the next character.
+            if (leadingWhitespace.length > 0) {
+                delimiter += leadingWhitespace;
+                nextContent = nextContent.slice(leadingWhitespace.length);
+            }
+            // Check if there is an equal or colon character.
+            if (/[:=]/.test(nextContent[0])) {
+                delimiter += nextContent[0];
+                nextContent = nextContent.slice(1);
+                // If an equal or colon character was found, try to get trailing whitespace.
+                var trailingWhitespaceMatch = nextContent.match(/^(?<whitespace>\s+)/);
+                var trailingWhitespace = ((_b = trailingWhitespaceMatch === null || trailingWhitespaceMatch === void 0 ? void 0 : trailingWhitespaceMatch.groups) === null || _b === void 0 ? void 0 : _b.whitespace) || '';
+                delimiter += trailingWhitespace;
+            }
+            this.delimiterLength = delimiter.length;
+            // If the line starts with a delimiter, the property has no key.
+            if (!position) {
+                this.hasNoKey = true;
+            }
+            break;
+        }
+        // If there was no delimiter found, the property has no value.
+        if (this.delimiterPosition === undefined) {
+            this.hasNoValue = true;
+        }
+        else {
+            // If the delimiter is after the first newline, mark the key as multiline.
+            if (this.newlinePositions.length > 0) {
+                var firstLinePosition = this.newlinePositions[0];
+                if (firstLinePosition > this.delimiterPosition) {
+                    this.hasMultilineKey = true;
+                }
+            }
+        }
+    };
+    return Property;
+}());
+exports.Property = Property;