properties-file 4.0.0 → 5.0.1

package/dist/esm/parser/properties.d.ts

@@ -0,0 +1,93 @@
+import type { BlankLineNode, CommentNode, KeyCollisions, KeyValuePairObject, NormalizeOptions, PropertiesNode, PropertyNode } from './nodes.js';
+/**
+ * A lossless, ordered representation of a `.properties` file.
+ *
+ * Every element in the file — properties, comments, and blank lines — is
+ * preserved in order. Duplicate keys are all retained. The original content
+ * can be reconstructed exactly via {@link format}.
+ */
+export declare class Properties {
+    /** Whether the content started with a BOM character. */
+    readonly hasBom: boolean;
+    /** The end-of-line character detected from the content. */
+    readonly eolCharacter: string;
+    /** All nodes in file order. */
+    readonly nodes: PropertiesNode[];
+    /**
+     * Parse a `.properties` file into a lossless node structure.
+     *
+     * @param content - The content of a `.properties` file (string or Buffer).
+     */
+    constructor(content: string | Buffer);
+    /**
+     * Get all property nodes in file order (including duplicates).
+     *
+     * @returns An array of all {@link PropertyNode} instances.
+     */
+    getProperties(): PropertyNode[];
+    /**
+     * Get all comment nodes in file order.
+     *
+     * @returns An array of all {@link CommentNode} instances.
+     */
+    getComments(): CommentNode[];
+    /**
+     * Get all blank line nodes in file order.
+     *
+     * @returns An array of all {@link BlankLineNode} instances.
+     */
+    getBlankLines(): BlankLineNode[];
+    /**
+     * Get the effective key-value map (last-wins semantics for duplicate keys).
+     *
+     * @returns A plain object where each key maps to its last-occurring value.
+     */
+    toObject(): KeyValuePairObject;
+    /**
+     * Get all property nodes for a given key (all occurrences, in file order).
+     *
+     * @param key - The unescaped key to search for.
+     *
+     * @returns An array of matching {@link PropertyNode} instances (empty if not found).
+     */
+    getPropertyNodes(key: string): PropertyNode[];
+    /**
+     * Get the effective property node for a given key (last occurrence).
+     *
+     * @param key - The unescaped key to search for.
+     *
+     * @returns The last {@link PropertyNode} with this key, or `undefined`.
+     */
+    getEffectiveProperty(key: string): PropertyNode | undefined;
+    /**
+     * Get keys that appear more than once, with all their property nodes.
+     *
+     * @returns An array of {@link KeyCollisions} for duplicate keys.
+     */
+    getKeyCollisions(): KeyCollisions[];
+    /**
+     * Get comment and blank line nodes immediately preceding a property.
+     *
+     * Walks backward from the last occurrence of the given key, collecting
+     * comment and blank line nodes until reaching another property or the
+     * start of the file.
+     *
+     * @param key - The unescaped key to find leading nodes for.
+     *
+     * @returns An array of preceding {@link CommentNode} and {@link BlankLineNode} instances.
+     */
+    getLeadingNodes(key: string): (CommentNode | BlankLineNode)[];
+    /**
+     * Format the `.properties` content as a string.
+     *
+     * Without options, produces an exact lossless reconstruction of the original
+     * content. With options, produces normalized output — standardize separators,
+     * remove comments, deduplicate keys, and more.
+     *
+     * @param options - Optional normalization options. When omitted, the output
+     *   is a lossless round-trip of the original content.
+     *
+     * @returns The formatted `.properties` file content.
+     */
+    format(options?: NormalizeOptions): string;
+}

package/dist/esm/parser/properties.js

@@ -0,0 +1 @@
+function _class_call_check(e,r){if(!(e instanceof r))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,r){for(var t=0;t<r.length;t++){var n=r[t];n.enumerable=n.enumerable||!1,n.configurable=!0,"value"in n&&(n.writable=!0),Object.defineProperty(e,n.key,n)}}function _create_class(e,r,t){return r&&_defineProperties(e.prototype,r),t&&_defineProperties(e,t),e}import{formatNormalized as formatNormalizedImpl}from"./normalize.js";import{parseDocument}from"./parse.js";var BOM="\ufeff";export var Properties=function(){"use strict";function e(r){_class_call_check(this,e);var t=parseDocument(r);this.hasBom=t.hasBom,this.eolCharacter=t.eolCharacter,this.nodes=t.nodes}return _create_class(e,[{key:"getProperties",value:function(){return this.nodes.filter(function(e){return"property"===e.type})}},{key:"getComments",value:function(){return this.nodes.filter(function(e){return"comment"===e.type})}},{key:"getBlankLines",value:function(){return this.nodes.filter(function(e){return"blank"===e.type})}},{key:"toObject",value:function(){var e={},r=!0,t=!1,n=void 0;try{for(var o,a=this.nodes[Symbol.iterator]();!(r=(o=a.next()).done);r=!0){var i=o.value;"property"===i.type&&(e[i.key]=i.value)}}catch(e){t=!0,n=e}finally{try{r||null==a.return||a.return()}finally{if(t)throw n}}return e}},{key:"getPropertyNodes",value:function(e){return this.nodes.filter(function(r){return"property"===r.type&&r.key===e})}},{key:"getEffectiveProperty",value:function(e){for(var r=this.nodes.length-1;r>=0;r--){var t=this.nodes[r];if("property"===t.type&&t.key===e)return t}}},{key:"getKeyCollisions",value:function(){var e={},r=!0,t=!1,n=void 0;try{for(var o,a=this.nodes[Symbol.iterator]();!(r=(o=a.next()).done);r=!0){var i=o.value;"property"===i.type&&(e[i.key]||(e[i.key]=[]),e[i.key].push(i))}}catch(e){t=!0,n=e}finally{try{r||null==a.return||a.return()}finally{if(t)throw n}}var l=[],s=!0,u=!1,f=void 0;try{for(var y,c=Object.keys(e)[Symbol.iterator]();!(s=(y=c.next()).done);s=!0){var h=y.value;e[h].length>1&&l.push({key:h,nodes:e[h]})}}catch(e){u=!0,f=e}finally{try{s||null==c.return||c.return()}finally{if(u)throw f}}return l}},{key:"getLeadingNodes",value:function(e){for(var r=-1,t=this.nodes.length-1;t>=0;t--){var n=this.nodes[t];if("property"===n.type&&n.key===e){r=t;break}}if(r<=0)return[];for(var o=[],a=r-1;a>=0;a--){var i=this.nodes[a];if("property"===i.type)break;o.unshift(i)}return o}},{key:"format",value:function(e){if(!e){var r=this.eolCharacter,t=[],n=!0,o=!1,a=void 0;try{for(var i,l=this.nodes[Symbol.iterator]();!(n=(i=l.next()).done);n=!0){var s=i.value;"property"===s.type?t.push(s.rawLines.join(r)):t.push(s.rawLine)}}catch(e){o=!0,a=e}finally{try{n||null==l.return||l.return()}finally{if(o)throw a}}return(this.hasBom?BOM:"")+t.join(r)}return formatNormalizedImpl(this.nodes,this.hasBom,this.eolCharacter,e)}}]),e}();

package/dist/esm/unescape/index.d.ts

@@ -1,6 +1,10 @@
 /**
  * Tries to unescape the content from either key or value of a property.
  *
+ * Uses a single-pass, segment-based approach with `charCodeAt()` instead of
+ * regex. Scans for backslashes, flushes literal text in bulk via `slice()`,
+ * and only builds new characters for actual escape sequences.
+ *
  * @param content - The content to unescape.
  *
  * @returns The unescaped content.

package/dist/esm/unescape/index.js

@@ -1 +1 @@
-var REGEX_INVALID_UNICODE_ESCAPE=/\\u(?![0-9a-fA-F]{4})/,REGEX_ESCAPE=/\\(?:([fnrt])|u([0-9a-fA-F]{4})|(.))/g,ESCAPE_MAP={f:"\f",n:"\n",r:"\r",t:"\t"};export var unescapeContent=function(r){var E;if(-1===r.indexOf("\\"))return r;var n=r.match(REGEX_INVALID_UNICODE_ESCAPE);if(n){var e=null!==(E=n.index)&&void 0!==E?E:0,a=r.slice(e,e+6);throw new Error("malformed escaped unicode characters '".concat(a,"'"))}return r.replace(REGEX_ESCAPE,function(r,E,n,e){return E?ESCAPE_MAP[E]:n?String.fromCharCode(parseInt(n,16)):null!=e?e:""})};
+var CH_BACKSLASH=92,CH_LOWER_F=102,CH_LOWER_N=110,CH_LOWER_R=114,CH_LOWER_T=116,CH_LOWER_U=117,isHexDigit=function(e){return e>=48&&e<=57||e>=65&&e<=70||e>=97&&e<=102},hexValue=function(e){return e>=48&&e<=57?e-48:e>=65&&e<=70?e-55:e-87};export var unescapeContent=function(e){if(-1===e.indexOf("\\"))return e;for(var r=e.length,a="",t=0,c=0;c<r;)if(e.charCodeAt(c)===CH_BACKSLASH){if(c>t&&(a+=e.slice(t,c)),++c>=r){a+="\\",t=c;break}switch(e.charCodeAt(c)){case CH_LOWER_N:a+="\n",c++;break;case CH_LOWER_T:a+="\t",c++;break;case CH_LOWER_R:a+="\r",c++;break;case CH_LOWER_F:a+="\f",c++;break;case CH_LOWER_U:if(c+4>=r||!isHexDigit(e.charCodeAt(c+1))||!isHexDigit(e.charCodeAt(c+2))||!isHexDigit(e.charCodeAt(c+3))||!isHexDigit(e.charCodeAt(c+4))){var i=e.slice(c-1,c+5);throw new Error("malformed escaped unicode characters '".concat(i,"'"))}var C=hexValue(e.charCodeAt(c+1))<<12|hexValue(e.charCodeAt(c+2))<<8|hexValue(e.charCodeAt(c+3))<<4|hexValue(e.charCodeAt(c+4));a+=String.fromCharCode(C),c+=5;break;default:a+=e.charAt(c),c++}t=c}else c++;return t<r&&(a+=e.slice(t,r)),a};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "properties-file",
-  "version": "4.0.0",
+  "version": "5.0.1",
   "description": ".properties file parser, editor, formatter and bundler integrations.",
   "keywords": [
     ".properties",
@@ -99,6 +99,16 @@
         "default": "./dist/cjs/escape/index.js"
       }
     },
+    "./parser": {
+      "import": {
+        "types": "./dist/esm/parser/index.d.ts",
+        "default": "./dist/esm/parser/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/parser/index.d.ts",
+        "default": "./dist/cjs/parser/index.js"
+      }
+    },
     "./unescape": {
       "import": {
         "types": "./dist/esm/unescape/index.d.ts",
@@ -117,54 +127,56 @@
     "dist"
   ],
   "scripts": {
-    "add-file-type-declaration": "node ./dist/esm/add-import-type.js && find ./dist -name 'add-import-type.*' -type f -delete",
-    "benchmark": "npx tsx benchmarks/run.ts",
-    "benchmark-compare": "npx tsx benchmarks/compare.ts",
-    "build": "npm run check-nvm-node-version && npm run prettier-write && npm run eslint-fix && rm -Rf ./dist && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && echo '{ \"type\": \"commonjs\" }' > dist/cjs/package.json && tsc -p src/build-scripts/tsconfig.json && node dist/build-scripts/build.js && npm run test",
+    "benchmark": "npx tsx performance/benchmarks/compare.ts",
+    "build": "npm run check-nvm-node-version && npm run prettier-write && npm run eslint-fix && rm -Rf ./dist && tsc && npx tsx src/build-scripts/build.ts && npm run test && npm run size",
     "check-nvm-node-version": "check-node-version --node $(node -p \"'>='+require('fs').readFileSync('.nvmrc','utf-8').trim()\")",
     "depcheck": "depcheck",
     "eslint-fix": "eslint --fix",
     "ncu": "npm-check-updates",
     "ncu-update": "npm-check-updates -u",
+    "performance-clean": "rm -rf performance/published-packages/.cache performance/benchmarks/.results performance/size/.results",
     "prepare": "husky",
     "prettier-write": "prettier --write .",
     "release": "dotenv -- release-it --only-version",
-    "test": "jest --coverage"
+    "size": "npx tsx performance/size/compare.ts",
+    "snapshot": "npx tsx performance/snapshots/manage.ts",
+    "test": "jest --coverage",
+    "test-node-compat": "docker build --platform linux/amd64 -f tests/node-compat/Dockerfile ."
   },
   "devDependencies": {
     "@release-it/conventional-changelog": "10.0.6",
-    "@types/bun": "1.3.11",
+    "@swc/core": "1.15.24",
+    "@types/bun": "1.3.12",
     "@types/jest": "30.0.0",
-    "@types/node": "25.5.0",
+    "@types/node": "25.6.0",
     "check-node-version": "4.2.1",
     "depcheck": "1.4.7",
     "dotenv-cli": "11.0.0",
-    "esbuild": "0.27.4",
-    "eslint": "10.1.0",
+    "esbuild": "0.28.0",
+    "eslint": "10.2.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-es-x": "9.6.0",
     "eslint-plugin-import-x": "4.16.2",
-    "eslint-plugin-jest": "29.15.0",
-    "eslint-plugin-package-json": "0.91.0",
+    "eslint-plugin-jest": "29.15.2",
+    "eslint-plugin-package-json": "0.91.1",
     "eslint-plugin-prefer-arrow-functions": "3.9.1",
     "eslint-plugin-prettier": "5.5.5",
     "eslint-plugin-tsdoc": "0.5.2",
-    "eslint-plugin-unicorn": "63.0.0",
+    "eslint-plugin-unicorn": "64.0.0",
     "husky": "9.1.7",
     "jest": "30.3.0",
     "jiti": "2.6.1",
     "jsonc-eslint-parser": "3.1.0",
-    "npm-check-updates": "19.6.5",
-    "prettier": "3.8.1",
-    "prettier-plugin-organize-imports": "4.3.0",
-    "release-it": "19.2.4",
-    "rollup": "4.60.0",
+    "npm-check-updates": "20.0.1",
+    "prettier": "3.8.2",
+    "release-it": "20.0.0-1",
+    "rollup": "4.60.1",
     "terser": "5.46.1",
     "tinybench": "6.0.0",
-    "ts-jest": "29.4.6",
-    "typescript": "5.9.3",
-    "typescript-eslint": "8.57.1"
+    "ts-jest": "29.4.9",
+    "typescript": "6.0.2",
+    "typescript-eslint": "8.58.1"
   },
   "engines": {
     "node": "*"

package/dist/cjs/properties.d.ts

@@ -1,96 +0,0 @@
-import { KeyValuePairObject } from '.';
-import { Property } from './property';
-/**
- * Byte-order mark.
- */
-export declare const BOM = "\uFEFF";
-export declare const BOM_CODE_POINT: number;
-/** Matches a newline, optionally preceded by a carriage return. */
-export declare const REGEX_NEWLINE: RegExp;
-/** The default end of line character. */
-export declare const DEFAULT_END_OF_LINE_CHARACTER = "\n";
-/**
- * Get the first end of line (EOL) character from multiline content.
- *
- * @param content - The content of a `.properties` file.
- *
- * @returns The multiline content's first end of line (EOL) character.
- */
-export declare const getFirstEolCharacter: (content: string) => string | undefined;
-/**
- * A class representing the content of a .properties file.
- */
-export declare class Properties {
-    /** Does the .properties content starts with a BOM character? */
-    readonly hasBom: boolean;
-    /** The end of line character. */
-    readonly eolCharacter: string;
-    /** `.properties` content split by line. */
-    protected lines: string[];
-    /** The collection of property object. */
-    collection: Property[];
-    /** Object associating keys with their starting line numbers. */
-    keyLineNumbers: KeyLineNumbers;
-    /**
-     * Create `Properties` object.
-     *
-     * @param content - The content of a `.properties` file.
-     */
-    constructor(content: string | Buffer);
-    /**
-     * Parse the `.properties` content line by line.
-     */
-    protected parseLines(): void;
-    /**
-     * Add a property object into a properties object collection.
-     *
-     * @param property - A property object, or undefined.
-     *
-     * @returns Undefined so that we conveniently overwrite the property object.
-     */
-    private addToCollection;
-    /**
-     * Get keys that have collisions (more than one occurrence).
-     */
-    getKeyCollisions(): KeyCollisions[];
-    /**
-     * Get the key/value object representing the properties.
-     *
-     * @returns A key/value object representing the properties.
-     */
-    toObject(): KeyValuePairObject;
-    /**
-     * Format the object in `.properties`.
-     *
-     * @param endOfLineCharacter - The character used for end of lines.
-     *
-     * @returns The object in `.properties` format.
-     */
-    format(endOfLineCharacter?: '\n' | '\r\n'): string;
-}
-/**
- * Object associating keys with their line numbers.
- */
-export type KeyLineNumbers = {
-    [key: string]: number[];
-};
-/**
- * A class representing key within a .properties file that had collisions (more than one occurrence).
- */
-export declare class KeyCollisions {
-    /** The key with collisions. */
-    key: string;
-    /** The starting line numbers where collisions are found. */
-    startingLineNumbers: number[];
-    /**
-     * Create a new key collision object.
-     *
-     * @param key - The key with collisions.
-     * @param startingLineNumbers - The starting line numbers where collisions are found.
-     */
-    constructor(key: string, startingLineNumbers: number[]);
-    /**
-     * Get the number of the line from which the value will be used.
-     */
-    getApplicableLineNumber(): number | undefined;
-}

package/dist/cjs/properties.js

@@ -1 +0,0 @@
-"use strict";var __values=this&&this.__values||function(e){var t="function"==typeof Symbol&&Symbol.iterator,r=t&&e[t],i=0;if(r)return r.call(e);if(e&&"number"==typeof e.length)return{next:function(){return e&&i>=e.length&&(e=void 0),{value:e&&e[i++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")};Object.defineProperty(exports,"__esModule",{value:!0}),exports.KeyCollisions=exports.Properties=exports.getFirstEolCharacter=exports.DEFAULT_END_OF_LINE_CHARACTER=exports.REGEX_NEWLINE=exports.BOM_CODE_POINT=exports.BOM=void 0;var property_1=require("./property"),property_line_1=require("./property-line");exports.BOM="\ufeff",exports.BOM_CODE_POINT=exports.BOM.charCodeAt(0),exports.REGEX_NEWLINE=/\r?\n/,exports.DEFAULT_END_OF_LINE_CHARACTER="\n";var getFirstEolCharacter=function(e){var t=e.indexOf("\n");return-1===t?void 0:"".concat("\r"===e[t-1]?"\r":"","\n")};exports.getFirstEolCharacter=getFirstEolCharacter;var Properties=function(){function e(e){var t;this.collection=[],this.keyLineNumbers={};var r="string"==typeof e?e:e.toString();this.hasBom=r.charCodeAt(0)===exports.BOM_CODE_POINT,this.eolCharacter=null!==(t=(0,exports.getFirstEolCharacter)(r))&&void 0!==t?t:exports.DEFAULT_END_OF_LINE_CHARACTER,this.lines=(this.hasBom?r.slice(1):r).split(exports.REGEX_NEWLINE),this.parseLines()}return e.prototype.parseLines=function(){var e,t;this.collection=[],this.keyLineNumbers={};var r,i,o=0;try{for(var n=__values(this.lines),s=n.next();!s.done;s=n.next()){var l=s.value;o++;var a=new property_line_1.PropertyLine(l,!!r);if(r){if(r.addLine(a),a.isContinuing)continue}else{if(a.isComment||a.isBlank)continue;if(r=new property_1.Property(a,o,i),a.isContinuing)continue}this.addToCollection(r),i=r,r=void 0}}catch(t){e={error:t}}finally{try{s&&!s.done&&(t=n.return)&&t.call(n)}finally{if(e)throw e.error}}},e.prototype.addToCollection=function(e){var t;e.setKeyAndValue(),(null===(t=this.keyLineNumbers[e.key])||void 0===t?void 0:t.length)?(this.keyLineNumbers[e.key].push(e.startingLineNumber),e.hasKeyCollisions=!0,e.keyCollisionLines=this.keyLineNumbers[e.key],this.collection=this.collection.filter(function(t){return t.key!==e.key})):this.keyLineNumbers[e.key]=[e.startingLineNumber],this.collection.push(e)},e.prototype.getKeyCollisions=function(){var e,t,r=[],i=Object.keys(this.keyLineNumbers);try{for(var o=__values(i),n=o.next();!n.done;n=o.next()){var s=n.value,l=this.keyLineNumbers[s];l.length>1&&r.push(new KeyCollisions(s,l))}}catch(t){e={error:t}}finally{try{n&&!n.done&&(t=o.return)&&t.call(o)}finally{if(e)throw e.error}}return r},e.prototype.toObject=function(){var e={};return this.collection.forEach(function(t){e[t.key]=t.value}),e},e.prototype.format=function(e){return"".concat(this.hasBom?exports.BOM:"").concat(this.lines.join(e||this.eolCharacter))},e}();exports.Properties=Properties;var KeyCollisions=function(){function e(e,t){this.key=e,this.startingLineNumbers=t}return e.prototype.getApplicableLineNumber=function(){return this.startingLineNumbers.slice(-1)[0]},e}();exports.KeyCollisions=KeyCollisions;

package/dist/cjs/property-line.d.ts

@@ -1,22 +0,0 @@
-/**
- * Object representing a line from the content of .properties file.
- */
-export declare class PropertyLine {
-    /** The line content, minus the trailing `\` that identifies that the line is continuing. */
-    content: string;
-    /** True if the line is continuing to the next line, otherwise false. */
-    isContinuing: boolean;
-    /** True if the line is blank, otherwise false. */
-    isBlank: boolean;
-    /** True if the line is a comment, otherwise false. */
-    isComment: boolean;
-    /** Is the line object a continuation from a previous line? */
-    isMultiline: boolean;
-    /**
-     * Create a new line object.
-     *
-     * @param line - The raw content of a line.
-     * @param isMultiline - Is the line spreading on multiple lines?
-     */
-    constructor(line: string, isMultiline: boolean);
-}

package/dist/cjs/property-line.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.PropertyLine=void 0;var REGEX_LEADING_WHITESPACE=/^\s+/,REGEX_COMMENT=/^[!#]/,REGEX_TRAILING_BACKSLASHES=/(\\+)$/,PropertyLine=function(t,i){if(this.isContinuing=!1,this.isBlank=!1,this.isComment=!1,this.content=t.replace(REGEX_LEADING_WHITESPACE,""),this.isMultiline=i,0===this.content.length)this.isBlank=!0;else if(this.isMultiline||(this.isComment=REGEX_COMMENT.test(this.content)),!this.isComment){var e=this.content.match(REGEX_TRAILING_BACKSLASHES);e&&(this.isContinuing=e[1].length%2==1,this.isContinuing&&(this.content=this.content.slice(0,-1)))}};exports.PropertyLine=PropertyLine;

package/dist/cjs/property.d.ts

@@ -1,81 +0,0 @@
-import { PropertyLine } from './property-line';
-/**
- * Object representing a property (key/value).
- */
-export declare class Property {
-    /** The content of one or multiple lines when applicable. */
-    linesContent: string;
-    /** The property key (unescaped). */
-    key: string;
-    /** The property key, including its escaped characters. */
-    escapedKey: string;
-    /** Is the key empty? */
-    private hasNoKey;
-    /** Does the key definition spread across multiple lines? */
-    private hasMultilineKey;
-    /** Starting line numbers of property objects with the same key. */
-    keyCollisionLines: number[];
-    /** Was the property's key used more than once? */
-    hasKeyCollisions: boolean;
-    /** The key/value pair separator */
-    separator: string | undefined;
-    /** The length of the key/value pair separator, including its whitespace characters. */
-    separatorLength: number | undefined;
-    /** The starting position of the key/value pair separator. */
-    separatorPosition: number | undefined;
-    /** The property value (unescaped). */
-    value: string;
-    /** The starting position of the value. */
-    valuePosition: number | undefined;
-    /** The property value, including its escaped characters. */
-    escapedValue: string;
-    /** Positions of the newline characters if any. */
-    newlinePositions: number[];
-    /** The line number at which the property starts. */
-    readonly startingLineNumber: number;
-    /** The line number at which the property ends. */
-    endingLineNumber: number;
-    /** The previous property object if it exists. */
-    readonly previousProperty?: Property;
-    /** The next property object if it exists. */
-    nextProperty?: Property;
-    /**
-     * 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, previousProperty?: Property);
-    /**
-     * Set the next property object.
-     *
-     * @param property - The next property object
-     */
-    setNextProperty(property: Property): void;
-    /**
-     * 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.
-     *
-     * @throws {@link Error}
-     * This exception is thrown if malformed escaped unicode characters are present.
-     */
-    private unescapeLine;
-    /**
-     * Find the character separating the key from the value.
-     */
-    private findSeparator;
-}

package/dist/cjs/property.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.Property=void 0;var unescape_1=require("./unescape"),REGEX_TRAILING_BACKSLASHES=/(\\+)$/,REGEX_LEADING_WHITESPACE=/^([\t\n\v\f\r ]+)/,REGEX_SEPARATOR=/[\t\f :=]/g,REGEX_COLON_OR_EQUALS=/[:=]/,Property=function(){function t(t,e,i){this.key="",this.escapedKey="",this.hasNoKey=!1,this.hasMultilineKey=!1,this.keyCollisionLines=[],this.hasKeyCollisions=!1,this.value="",this.escapedValue="",this.newlinePositions=[],this.linesContent=t.content,this.startingLineNumber=e,this.endingLineNumber=e,this.previousProperty=i,null==i||i.setNextProperty(this)}return t.prototype.setNextProperty=function(t){this.nextProperty=t},t.prototype.addLine=function(t){this.linesContent.length>0&&(this.newlinePositions.push(this.linesContent.length),this.endingLineNumber++),this.linesContent+=t.content},t.prototype.setKeyAndValue=function(){this.findSeparator(),void 0!==this.separatorPosition&&void 0!==this.separatorLength?(this.hasNoKey||(this.escapedKey=this.linesContent.slice(0,this.separatorPosition),this.key=this.unescapeLine(this.escapedKey,this.startingLineNumber)),this.escapedValue=this.linesContent.slice(this.separatorPosition+this.separatorLength),this.value=this.unescapeLine(this.escapedValue,this.startingLineNumber)):(this.escapedKey=this.linesContent,this.key=this.unescapeLine(this.escapedKey,this.startingLineNumber))},t.prototype.unescapeLine=function(t,e){try{return(0,unescape_1.unescapeContent)(t)}catch(t){throw new Error("".concat(t.message," in property starting at line ").concat(e))}},t.prototype.findSeparator=function(){var t,e,i,s;if(!this.hasNoKey&&!this.separator){var n;for(REGEX_SEPARATOR.lastIndex=0;null!==(n=REGEX_SEPARATOR.exec(this.linesContent));){var o=n.index,r=this.linesContent.slice(0,o).match(REGEX_TRAILING_BACKSLASHES);if(r)if(r[1].length%2==1)continue;var h="";this.separatorPosition=o;var a=this.linesContent.slice(o),l=null!==(e=null===(t=a.match(REGEX_LEADING_WHITESPACE))||void 0===t?void 0:t[0])&&void 0!==e?e:"";l.length>0&&(h+=l,a=a.slice(l.length)),REGEX_COLON_OR_EQUALS.test(a[0])&&(h+=a[0],h+=null!==(s=null===(i=(a=a.slice(1)).match(REGEX_LEADING_WHITESPACE))||void 0===i?void 0:i[0])&&void 0!==s?s:""),this.separatorLength=h.length,this.valuePosition=this.separatorPosition+this.separatorLength,this.separator=this.linesContent.slice(this.separatorPosition,this.separatorPosition+this.separatorLength),o||(this.hasNoKey=!0);break}void 0!==this.separatorPosition&&this.newlinePositions.length>0&&this.newlinePositions[0]<this.separatorPosition&&(this.hasMultilineKey=!0)}},t}();exports.Property=Property;

package/dist/esm/properties.d.ts

@@ -1,96 +0,0 @@
-import { KeyValuePairObject } from './index.js';
-import { Property } from './property.js';
-/**
- * Byte-order mark.
- */
-export declare const BOM = "\uFEFF";
-export declare const BOM_CODE_POINT: number;
-/** Matches a newline, optionally preceded by a carriage return. */
-export declare const REGEX_NEWLINE: RegExp;
-/** The default end of line character. */
-export declare const DEFAULT_END_OF_LINE_CHARACTER = "\n";
-/**
- * Get the first end of line (EOL) character from multiline content.
- *
- * @param content - The content of a `.properties` file.
- *
- * @returns The multiline content's first end of line (EOL) character.
- */
-export declare const getFirstEolCharacter: (content: string) => string | undefined;
-/**
- * A class representing the content of a .properties file.
- */
-export declare class Properties {
-    /** Does the .properties content starts with a BOM character? */
-    readonly hasBom: boolean;
-    /** The end of line character. */
-    readonly eolCharacter: string;
-    /** `.properties` content split by line. */
-    protected lines: string[];
-    /** The collection of property object. */
-    collection: Property[];
-    /** Object associating keys with their starting line numbers. */
-    keyLineNumbers: KeyLineNumbers;
-    /**
-     * Create `Properties` object.
-     *
-     * @param content - The content of a `.properties` file.
-     */
-    constructor(content: string | Buffer);
-    /**
-     * Parse the `.properties` content line by line.
-     */
-    protected parseLines(): void;
-    /**
-     * Add a property object into a properties object collection.
-     *
-     * @param property - A property object, or undefined.
-     *
-     * @returns Undefined so that we conveniently overwrite the property object.
-     */
-    private addToCollection;
-    /**
-     * Get keys that have collisions (more than one occurrence).
-     */
-    getKeyCollisions(): KeyCollisions[];
-    /**
-     * Get the key/value object representing the properties.
-     *
-     * @returns A key/value object representing the properties.
-     */
-    toObject(): KeyValuePairObject;
-    /**
-     * Format the object in `.properties`.
-     *
-     * @param endOfLineCharacter - The character used for end of lines.
-     *
-     * @returns The object in `.properties` format.
-     */
-    format(endOfLineCharacter?: '\n' | '\r\n'): string;
-}
-/**
- * Object associating keys with their line numbers.
- */
-export type KeyLineNumbers = {
-    [key: string]: number[];
-};
-/**
- * A class representing key within a .properties file that had collisions (more than one occurrence).
- */
-export declare class KeyCollisions {
-    /** The key with collisions. */
-    key: string;
-    /** The starting line numbers where collisions are found. */
-    startingLineNumbers: number[];
-    /**
-     * Create a new key collision object.
-     *
-     * @param key - The key with collisions.
-     * @param startingLineNumbers - The starting line numbers where collisions are found.
-     */
-    constructor(key: string, startingLineNumbers: number[]);
-    /**
-     * Get the number of the line from which the value will be used.
-     */
-    getApplicableLineNumber(): number | undefined;
-}

package/dist/esm/properties.js

@@ -1 +0,0 @@
-var __values=this&&this.__values||function(e){var t="function"==typeof Symbol&&Symbol.iterator,r=t&&e[t],i=0;if(r)return r.call(e);if(e&&"number"==typeof e.length)return{next:function(){return e&&i>=e.length&&(e=void 0),{value:e&&e[i++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")};import{Property}from"./property.js";import{PropertyLine}from"./property-line.js";export var BOM="\ufeff";export var BOM_CODE_POINT=BOM.charCodeAt(0);export var REGEX_NEWLINE=/\r?\n/;export var DEFAULT_END_OF_LINE_CHARACTER="\n";export var getFirstEolCharacter=function(e){var t=e.indexOf("\n");return-1===t?void 0:"".concat("\r"===e[t-1]?"\r":"","\n")};var Properties=function(){function e(e){var t;this.collection=[],this.keyLineNumbers={};var r="string"==typeof e?e:e.toString();this.hasBom=r.charCodeAt(0)===BOM_CODE_POINT,this.eolCharacter=null!==(t=getFirstEolCharacter(r))&&void 0!==t?t:DEFAULT_END_OF_LINE_CHARACTER,this.lines=(this.hasBom?r.slice(1):r).split(REGEX_NEWLINE),this.parseLines()}return e.prototype.parseLines=function(){var e,t;this.collection=[],this.keyLineNumbers={};var r,i,n=0;try{for(var o=__values(this.lines),s=o.next();!s.done;s=o.next()){var l=s.value;n++;var a=new PropertyLine(l,!!r);if(r){if(r.addLine(a),a.isContinuing)continue}else{if(a.isComment||a.isBlank)continue;if(r=new Property(a,n,i),a.isContinuing)continue}this.addToCollection(r),i=r,r=void 0}}catch(t){e={error:t}}finally{try{s&&!s.done&&(t=o.return)&&t.call(o)}finally{if(e)throw e.error}}},e.prototype.addToCollection=function(e){var t;e.setKeyAndValue(),(null===(t=this.keyLineNumbers[e.key])||void 0===t?void 0:t.length)?(this.keyLineNumbers[e.key].push(e.startingLineNumber),e.hasKeyCollisions=!0,e.keyCollisionLines=this.keyLineNumbers[e.key],this.collection=this.collection.filter(function(t){return t.key!==e.key})):this.keyLineNumbers[e.key]=[e.startingLineNumber],this.collection.push(e)},e.prototype.getKeyCollisions=function(){var e,t,r=[],i=Object.keys(this.keyLineNumbers);try{for(var n=__values(i),o=n.next();!o.done;o=n.next()){var s=o.value,l=this.keyLineNumbers[s];l.length>1&&r.push(new KeyCollisions(s,l))}}catch(t){e={error:t}}finally{try{o&&!o.done&&(t=n.return)&&t.call(n)}finally{if(e)throw e.error}}return r},e.prototype.toObject=function(){var e={};return this.collection.forEach(function(t){e[t.key]=t.value}),e},e.prototype.format=function(e){return"".concat(this.hasBom?BOM:"").concat(this.lines.join(e||this.eolCharacter))},e}();export{Properties};var KeyCollisions=function(){function e(e,t){this.key=e,this.startingLineNumbers=t}return e.prototype.getApplicableLineNumber=function(){return this.startingLineNumbers.slice(-1)[0]},e}();export{KeyCollisions};

package/dist/esm/property-line.d.ts

@@ -1,22 +0,0 @@
-/**
- * Object representing a line from the content of .properties file.
- */
-export declare class PropertyLine {
-    /** The line content, minus the trailing `\` that identifies that the line is continuing. */
-    content: string;
-    /** True if the line is continuing to the next line, otherwise false. */
-    isContinuing: boolean;
-    /** True if the line is blank, otherwise false. */
-    isBlank: boolean;
-    /** True if the line is a comment, otherwise false. */
-    isComment: boolean;
-    /** Is the line object a continuation from a previous line? */
-    isMultiline: boolean;
-    /**
-     * Create a new line object.
-     *
-     * @param line - The raw content of a line.
-     * @param isMultiline - Is the line spreading on multiple lines?
-     */
-    constructor(line: string, isMultiline: boolean);
-}

package/dist/esm/property-line.js

@@ -1 +0,0 @@
-var REGEX_LEADING_WHITESPACE=/^\s+/,REGEX_COMMENT=/^[!#]/,REGEX_TRAILING_BACKSLASHES=/(\\+)$/,PropertyLine=function(t,i){if(this.isContinuing=!1,this.isBlank=!1,this.isComment=!1,this.content=t.replace(REGEX_LEADING_WHITESPACE,""),this.isMultiline=i,0===this.content.length)this.isBlank=!0;else if(this.isMultiline||(this.isComment=REGEX_COMMENT.test(this.content)),!this.isComment){var n=this.content.match(REGEX_TRAILING_BACKSLASHES);n&&(this.isContinuing=n[1].length%2==1,this.isContinuing&&(this.content=this.content.slice(0,-1)))}};export{PropertyLine};

package/dist/esm/property.d.ts

@@ -1,81 +0,0 @@
-import { PropertyLine } from './property-line.js';
-/**
- * Object representing a property (key/value).
- */
-export declare class Property {
-    /** The content of one or multiple lines when applicable. */
-    linesContent: string;
-    /** The property key (unescaped). */
-    key: string;
-    /** The property key, including its escaped characters. */
-    escapedKey: string;
-    /** Is the key empty? */
-    private hasNoKey;
-    /** Does the key definition spread across multiple lines? */
-    private hasMultilineKey;
-    /** Starting line numbers of property objects with the same key. */
-    keyCollisionLines: number[];
-    /** Was the property's key used more than once? */
-    hasKeyCollisions: boolean;
-    /** The key/value pair separator */
-    separator: string | undefined;
-    /** The length of the key/value pair separator, including its whitespace characters. */
-    separatorLength: number | undefined;
-    /** The starting position of the key/value pair separator. */
-    separatorPosition: number | undefined;
-    /** The property value (unescaped). */
-    value: string;
-    /** The starting position of the value. */
-    valuePosition: number | undefined;
-    /** The property value, including its escaped characters. */
-    escapedValue: string;
-    /** Positions of the newline characters if any. */
-    newlinePositions: number[];
-    /** The line number at which the property starts. */
-    readonly startingLineNumber: number;
-    /** The line number at which the property ends. */
-    endingLineNumber: number;
-    /** The previous property object if it exists. */
-    readonly previousProperty?: Property;
-    /** The next property object if it exists. */
-    nextProperty?: Property;
-    /**
-     * 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, previousProperty?: Property);
-    /**
-     * Set the next property object.
-     *
-     * @param property - The next property object
-     */
-    setNextProperty(property: Property): void;
-    /**
-     * 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.
-     *
-     * @throws {@link Error}
-     * This exception is thrown if malformed escaped unicode characters are present.
-     */
-    private unescapeLine;
-    /**
-     * Find the character separating the key from the value.
-     */
-    private findSeparator;
-}