properties-file 5.0.0 → 5.0.1

package/README.md

@@ -1,253 +1,253 @@
-# properties-file
-
-[![License](https://img.shields.io/npm/l/make-coverage-badge.svg?color=brightgreen)](https://opensource.org/licenses/MIT)
-[![Download Stats](https://img.shields.io/npm/dw/properties-file.svg?color=brightgreen)](https://www.npmjs.com/package/properties-file)
-![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)
-![Package Size](https://img.shields.io/badge/min%2Bgzip-1.1%20kB-brightgreen)
-![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)
-
-`.properties` file parser, editor, formatter and bundler integrations.
-
-## Installation
-
-> Doing a major version update? Check our [migration guides](./docs/migration/README.md).
-
-Add the package as a dependency:
-
-```
-npm install properties-file
-```
-
-## What's in it for me?
-
-- A modern library written entirely in TypeScript that exactly reproduces the [Properties Java implementation](/assets/java-implementation.md).
-- Works for both Node.js applications and browsers that support at least [ES5](https://www.w3schools.com/js/js_es5.asp).
-- Flexible, tree-shakable APIs — import only what you need, and your bundler will exclude the rest:
-  - `getProperties` converts `.properties` content to a key-value pair object.
-  - `Properties` provides lossless parsing with a full data model — every element (properties, comments, blank lines, whitespace, duplicate keys) is preserved and can be round-tripped exactly or normalized via `format()` options.
-  - `PropertiesEditor` enables insertion, edition, and removal of entries while preserving formatting.
-  - `escapeKey` and `escapeValue` convert any content to `.properties` compatible format.
-  - Bundler integrations for Webpack, Rollup/Vite, esbuild, and Bun to import `.properties` files directly. See [BUNDLER.md](./docs/BUNDLER.md).
-- **Tiny with 0 dependencies** — `getProperties` is only 1.1 kB min+gzip.
-- **Runs everywhere** — compiled to ES5, works in any browser and on Node.js all the way back to v0.10 (2013). [Verified via Docker](./tests/node-compat/).
-- **100% test coverage** based on the output from a Java implementation.
-- Active maintenance (many popular `.properties` packages have been inactive for years). See our [detailed comparison](./docs/COMPARISON.md) with other packages.
-
-## Usage
-
-We have put a lot of effort into incorporating [TSDoc](https://tsdoc.org/) into all our APIs. If you are unsure about how to use certain APIs provided in our examples, please check directly in your IDE.
-
-### `getProperties` (converting `.properties` to an object)
-
-The most common use case for `.properties` files is for Node.js applications that need to read the file's content into a simple key-value pair object. Here is how this can be done with a single API call:
-
-```ts
-import { readFileSync } from 'node:fs'
-import { getProperties } from 'properties-file'
-
-console.log(getProperties(readFileSync('hello-world.properties')))
-```
-
-Output:
-
-```js
-{ hello: 'hello', world: 'world' }
-```
-
-### `Properties` (lossless parsing with full data model)
-
-The `Properties` class parses a `.properties` file into a lossless data model where every element — properties, comments, blank lines — is preserved in order. This is useful when you need to inspect, analyze, or transform `.properties` files while retaining their exact structure.
-
-```ts
-import { readFileSync } from 'node:fs'
-import { PropertiesNodeType, Properties } from 'properties-file/parser'
-
-const properties = new Properties(readFileSync('example.properties'))
-
-// Access all nodes in file order (properties, comments, blank lines).
-for (const node of properties.nodes) {
-  switch (node.type) {
-    case PropertiesNodeType.PROPERTY:
-      console.log(`${node.key} = ${node.value}`)
-      break
-    case PropertiesNodeType.COMMENT:
-      console.log(`Comment: ${node.delimiter}${node.body}`)
-      break
-    case PropertiesNodeType.BLANK:
-      console.log('(blank line)')
-      break
-  }
-}
-
-// Get a simple key-value object (last-wins for duplicate keys).
-console.log(properties.toObject())
-
-// Lossless round-trip: format() reproduces the exact original content.
-console.log(properties.format() === readFileSync('example.properties', 'utf8')) // true
-```
-
-#### Finding key collisions
-
-```ts
-import { Properties } from 'properties-file/parser'
-
-const properties = new Properties(
-  'hello = hello1\nworld = world1\nworld = world2\nhello = hello2\nworld = world3'
-)
-
-const collisions = properties.getKeyCollisions()
-collisions.forEach((collision) => {
-  const lines = collision.nodes.map((node) => node.startingLineNumber)
-  console.log(`Key '${collision.key}' appears on lines ${lines.join(', ')}`)
-})
-
-/**
- * Outputs:
- *
- * Key 'hello' appears on lines 1, 4
- * Key 'world' appears on lines 2, 3, 5
- */
-```
-
-#### Normalizing output
-
-Passing options to `format()` produces a normalized version of the file with granular control over formatting:
-
-```ts
-import { Properties } from 'properties-file/parser'
-
-const properties = new Properties('# comment\n\n    key : value\n    key : updated')
-
-console.log(
-  properties.format({
-    removeComments: true, // Strip all comments
-    removeBlankLines: true, // Strip all blank lines
-    removeLeadingWhitespace: true, // Strip indentation
-    deduplicateKeys: true, // Keep only last occurrence
-    separatorChar: '=', // Standardize separator
-    separatorLeading: ' ', // Space before =
-    separatorTrailing: ' ', // Space after =
-  })
-)
-
-/**
- * Outputs:
- *
- * key = updated
- */
-```
-
-### `PropertiesEditor` (editing `.properties` content)
-
-The `PropertiesEditor` extends `Properties` with methods to insert, update, delete, and upsert entries while preserving formatting.
-
-```ts
-import { PropertiesEditor } from 'properties-file/editor'
-
-const properties = new PropertiesEditor('hello = hello\n# This is a comment\nworld = world')
-
-properties.insertComment('This is a multiline\ncomment before `newKey3`')
-properties.insert('newKey3', 'This is my third key')
-
-properties.insert('newKey1', 'This is my first new key', {
-  referenceKey: 'newKey3',
-  position: 'before',
-  comment: 'Below are the new keys being edited',
-  commentDelimiter: '!',
-})
-
-properties.insert('newKey2', 'hello', {
-  referenceKey: 'newKey1',
-  position: 'after',
-  escapeUnicode: true,
-})
-
-properties.delete('hello')
-properties.update('world', {
-  newValue: 'new world',
-})
-console.log(properties.format())
-
-/**
- * Outputs:
- *
- * # This is a comment
- * world = new world
- * ! Below are the new keys being edited
- * newKey1 = This is my first new key
- * newKey2 = hello
- * # This is a multiline
- * # comment before `newKey3`
- * newKey3 = This is my third key
- */
-```
-
-The editor also provides `upsert` (update or insert) and `deleteAll` (remove all occurrences of a duplicate key). Check your IDE for all available methods and options via TSDoc.
-
-### Bundler Integrations
-
-If you would like to import `.properties` directly using `import`, this package provides integrations for all major bundlers: **Webpack/Rspack**, **Rollup/Vite/Rolldown**, **esbuild**, and **Bun**.
-
-See [BUNDLER.md](./docs/BUNDLER.md) for setup instructions and examples.
-
-By adding these configurations you should now be able to import directly `.properties` files just like this:
-
-```ts
-import { properties as helloWorld } from './hello-world.properties'
-
-console.dir(helloWorld)
-```
-
-Output:
-
-```json
-{ "hello": "world" }
-```
-
-## Why another `.properties` file package?
-
-There are over 20 similar packages available, but most are abandoned, incomplete, or not compliant with the Java specification. See our [detailed comparison](./docs/COMPARISON.md) for benchmarks, compliance tests, and a feature matrix against the top 5 packages. The short version:
-
-- **100% Java spec compliance** — the only package (alongside `properties-parser`) to pass all test cases.
-- **3–7x faster** than alternatives on a 10,000-entry file.
-- **Lossless data model** — no other package preserves comments, blank lines, whitespace, and duplicate keys for round-trip editing.
-
-Unfortunately, the `.properties` file specification is not well-documented. One reason for this is that it was originally used in Java to store configurations. Today, most applications handle this using JSON, YAML, or other modern formats because these formats are more flexible.
-
-### So why `.properties` files?
-
-While many options exist today to handle configurations, `.properties` files remain one of the best options to store localizable strings (also known as messages). On the Java side, `PropertyResourceBundle` is how most implementations handle localization today. Because of its simplicity and maturity, `.properties` files remain one of the best options today when it comes to internationalization (i18n):
-
-| File format   | Key/value based  | Supports inline comments | Built for localization | Good linguistic tools support |
-| ------------- | ---------------- | ------------------------ | ---------------------- | ----------------------------- |
-| `.properties` | Yes              | Yes                      | Yes (Resource Bundles) | Yes                           |
-| `JSON`        | No (can do more) | No (requires JSON5)      | No                     | Depends on the schema         |
-| `YAML`        | No (can do more) | Yes                      | No                     | Depends on the schema         |
-
-Having good JavaScript/TypeScript support for `.properties` files offers more internationalization (i18n) options.
-
-### How does this package work?
-
-Our goal is to offer parity with the Java implementation, which is the closest thing to a specification for `.properties` files. The package provides two parsing paths:
-
-1. **`getProperties`** — a fast, functional parser optimized for the common case of converting `.properties` content to a key-value object. Uses `charCodeAt`-based scanning with zero-copy optimizations.
-
-2. **`Properties`** — a lossless parser that produces an ordered array of typed nodes (`PropertyNode`, `CommentNode`, `BlankLineNode`). Every element in the file is preserved, enabling exact round-trip reconstruction via `format()` and flexible normalization by passing options to `format()`.
-
-Both parsers are fully compliant with the Java `Properties` specification and produce identical key-value output. Just like Java, if a Unicode-escaped character (`\u`) is malformed, an error will be thrown.
-
-## Contributing
-
-See [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for project principles, architecture, code style, and development commands.
-
-## Additional references
-
-- Java [Test Sandbox](https://codehs.com/sandbox/id/java-main-FObePj)
-- Java's `Properties` class [documentation](https://docs.oracle.com/javase/9/docs/api/java/util/Properties.html)
-- Java's `PropertyResourceBundle` [documentation](https://docs.oracle.com/javase/9/docs/api/java/util/PropertyResourceBundle.html)
-- Java's Internationalization [Guide](https://docs.oracle.com/en/java/javase/18/intl/internationalization-overview.html)
-- Wikipedia's .properties [page](https://en.wikipedia.org/wiki/.properties)
-
-### Special mention
-
-Thanks to [@calibr](https://github.com/calibr), the creator of [properties-file version 1.0](https://github.com/calibr/properties-file), for letting us use the [https://www.npmjs.com/package/properties-file](https://www.npmjs.com/package/properties-file) package name. We hope that it will make it easier to find our package.
+# properties-file
+
+[![License](https://img.shields.io/npm/l/make-coverage-badge.svg?color=brightgreen)](https://opensource.org/licenses/MIT)
+[![Download Stats](https://img.shields.io/npm/dw/properties-file.svg?color=brightgreen)](https://www.npmjs.com/package/properties-file)
+![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)
+![Package Size](https://img.shields.io/badge/min%2Bgzip-1.1%20kB-brightgreen)
+![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)
+
+`.properties` file parser, editor, formatter and bundler integrations.
+
+## Installation
+
+> Doing a major version update? Check our [migration guides](./docs/migration/README.md).
+
+Add the package as a dependency:
+
+```
+npm install properties-file
+```
+
+## What's in it for me?
+
+- A modern library written entirely in TypeScript that exactly reproduces the [Properties Java implementation](/assets/java-implementation.md).
+- Works for both Node.js applications and browsers that support at least [ES5](https://www.w3schools.com/js/js_es5.asp).
+- Flexible, tree-shakable APIs — import only what you need, and your bundler will exclude the rest:
+  - `getProperties` converts `.properties` content to a key-value pair object.
+  - `Properties` provides lossless parsing with a full data model — every element (properties, comments, blank lines, whitespace, duplicate keys) is preserved and can be round-tripped exactly or normalized via `format()` options.
+  - `PropertiesEditor` enables insertion, edition, and removal of entries while preserving formatting.
+  - `escapeKey` and `escapeValue` convert any content to `.properties` compatible format.
+  - Bundler integrations for Webpack, Rollup/Vite, esbuild, and Bun to import `.properties` files directly. See [BUNDLER.md](./docs/BUNDLER.md).
+- **Tiny with 0 dependencies** — `getProperties` is only 1.1 kB min+gzip.
+- **Runs everywhere** — compiled to ES5, works in any browser and on Node.js all the way back to v0.10 (2013). [Verified via Docker](./tests/node-compat/).
+- **100% test coverage** based on the output from a Java implementation.
+- Active maintenance (many popular `.properties` packages have been inactive for years). See our [detailed comparison](./docs/COMPARISON.md) with other packages.
+
+## Usage
+
+We have put a lot of effort into incorporating [TSDoc](https://tsdoc.org/) into all our APIs. If you are unsure about how to use certain APIs provided in our examples, please check directly in your IDE.
+
+### `getProperties` (converting `.properties` to an object)
+
+The most common use case for `.properties` files is for Node.js applications that need to read the file's content into a simple key-value pair object. Here is how this can be done with a single API call:
+
+```ts
+import { readFileSync } from 'node:fs'
+import { getProperties } from 'properties-file'
+
+console.log(getProperties(readFileSync('hello-world.properties')))
+```
+
+Output:
+
+```js
+{ hello: 'hello', world: 'world' }
+```
+
+### `Properties` (lossless parsing with full data model)
+
+The `Properties` class parses a `.properties` file into a lossless data model where every element — properties, comments, blank lines — is preserved in order. This is useful when you need to inspect, analyze, or transform `.properties` files while retaining their exact structure.
+
+```ts
+import { readFileSync } from 'node:fs'
+import { PropertiesNodeType, Properties } from 'properties-file/parser'
+
+const properties = new Properties(readFileSync('example.properties'))
+
+// Access all nodes in file order (properties, comments, blank lines).
+for (const node of properties.nodes) {
+  switch (node.type) {
+    case PropertiesNodeType.PROPERTY:
+      console.log(`${node.key} = ${node.value}`)
+      break
+    case PropertiesNodeType.COMMENT:
+      console.log(`Comment: ${node.delimiter}${node.body}`)
+      break
+    case PropertiesNodeType.BLANK:
+      console.log('(blank line)')
+      break
+  }
+}
+
+// Get a simple key-value object (last-wins for duplicate keys).
+console.log(properties.toObject())
+
+// Lossless round-trip: format() reproduces the exact original content.
+console.log(properties.format() === readFileSync('example.properties', 'utf8')) // true
+```
+
+#### Finding key collisions
+
+```ts
+import { Properties } from 'properties-file/parser'
+
+const properties = new Properties(
+  'hello = hello1\nworld = world1\nworld = world2\nhello = hello2\nworld = world3'
+)
+
+const collisions = properties.getKeyCollisions()
+collisions.forEach((collision) => {
+  const lines = collision.nodes.map((node) => node.startingLineNumber)
+  console.log(`Key '${collision.key}' appears on lines ${lines.join(', ')}`)
+})
+
+/**
+ * Outputs:
+ *
+ * Key 'hello' appears on lines 1, 4
+ * Key 'world' appears on lines 2, 3, 5
+ */
+```
+
+#### Normalizing output
+
+Passing options to `format()` produces a normalized version of the file with granular control over formatting:
+
+```ts
+import { Properties } from 'properties-file/parser'
+
+const properties = new Properties('# comment\n\n    key : value\n    key : updated')
+
+console.log(
+  properties.format({
+    removeComments: true, // Strip all comments
+    removeBlankLines: true, // Strip all blank lines
+    removeLeadingWhitespace: true, // Strip indentation
+    deduplicateKeys: true, // Keep only last occurrence
+    separatorChar: '=', // Standardize separator
+    separatorLeading: ' ', // Space before =
+    separatorTrailing: ' ', // Space after =
+  })
+)
+
+/**
+ * Outputs:
+ *
+ * key = updated
+ */
+```
+
+### `PropertiesEditor` (editing `.properties` content)
+
+The `PropertiesEditor` extends `Properties` with methods to insert, update, delete, and upsert entries while preserving formatting.
+
+```ts
+import { PropertiesEditor } from 'properties-file/editor'
+
+const properties = new PropertiesEditor('hello = hello\n# This is a comment\nworld = world')
+
+properties.insertComment('This is a multiline\ncomment before `newKey3`')
+properties.insert('newKey3', 'This is my third key')
+
+properties.insert('newKey1', 'This is my first new key', {
+  referenceKey: 'newKey3',
+  position: 'before',
+  comment: 'Below are the new keys being edited',
+  commentDelimiter: '!',
+})
+
+properties.insert('newKey2', 'hello', {
+  referenceKey: 'newKey1',
+  position: 'after',
+  escapeUnicode: true,
+})
+
+properties.delete('hello')
+properties.update('world', {
+  newValue: 'new world',
+})
+console.log(properties.format())
+
+/**
+ * Outputs:
+ *
+ * # This is a comment
+ * world = new world
+ * ! Below are the new keys being edited
+ * newKey1 = This is my first new key
+ * newKey2 = hello
+ * # This is a multiline
+ * # comment before `newKey3`
+ * newKey3 = This is my third key
+ */
+```
+
+The editor also provides `upsert` (update or insert) and `deleteAll` (remove all occurrences of a duplicate key). Check your IDE for all available methods and options via TSDoc.
+
+### Bundler Integrations
+
+If you would like to import `.properties` directly using `import`, this package provides integrations for all major bundlers: **Webpack/Rspack**, **Rollup/Vite/Rolldown**, **esbuild**, and **Bun**.
+
+See [BUNDLER.md](./docs/BUNDLER.md) for setup instructions and examples.
+
+By adding these configurations you should now be able to import directly `.properties` files just like this:
+
+```ts
+import { properties as helloWorld } from './hello-world.properties'
+
+console.dir(helloWorld)
+```
+
+Output:
+
+```json
+{ "hello": "world" }
+```
+
+## Why another `.properties` file package?
+
+There are over 20 similar packages available, but most are abandoned, incomplete, or not compliant with the Java specification. See our [detailed comparison](./docs/COMPARISON.md) for benchmarks, compliance tests, and a feature matrix against the top 5 packages. The short version:
+
+- **100% Java spec compliance** — the only package (alongside `properties-parser`) to pass all test cases.
+- **3–7x faster** than alternatives on a 10,000-entry file.
+- **Lossless data model** — no other package preserves comments, blank lines, whitespace, and duplicate keys for round-trip editing.
+
+Unfortunately, the `.properties` file specification is not well-documented. One reason for this is that it was originally used in Java to store configurations. Today, most applications handle this using JSON, YAML, or other modern formats because these formats are more flexible.
+
+### So why `.properties` files?
+
+While many options exist today to handle configurations, `.properties` files remain one of the best options to store localizable strings (also known as messages). On the Java side, `PropertyResourceBundle` is how most implementations handle localization today. Because of its simplicity and maturity, `.properties` files remain one of the best options today when it comes to internationalization (i18n):
+
+| File format   | Key/value based  | Supports inline comments | Built for localization | Good linguistic tools support |
+| ------------- | ---------------- | ------------------------ | ---------------------- | ----------------------------- |
+| `.properties` | Yes              | Yes                      | Yes (Resource Bundles) | Yes                           |
+| `JSON`        | No (can do more) | No (requires JSON5)      | No                     | Depends on the schema         |
+| `YAML`        | No (can do more) | Yes                      | No                     | Depends on the schema         |
+
+Having good JavaScript/TypeScript support for `.properties` files offers more internationalization (i18n) options.
+
+### How does this package work?
+
+Our goal is to offer parity with the Java implementation, which is the closest thing to a specification for `.properties` files. The package provides two parsing paths:
+
+1. **`getProperties`** — a fast, functional parser optimized for the common case of converting `.properties` content to a key-value object. Uses `charCodeAt`-based scanning with zero-copy optimizations.
+
+2. **`Properties`** — a lossless parser that produces an ordered array of typed nodes (`PropertyNode`, `CommentNode`, `BlankLineNode`). Every element in the file is preserved, enabling exact round-trip reconstruction via `format()` and flexible normalization by passing options to `format()`.
+
+Both parsers are fully compliant with the Java `Properties` specification and produce identical key-value output. Just like Java, if a Unicode-escaped character (`\u`) is malformed, an error will be thrown.
+
+## Contributing
+
+See [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for project principles, architecture, code style, and development commands.
+
+## Additional references
+
+- Java [Test Sandbox](https://codehs.com/sandbox/id/java-main-FObePj)
+- Java's `Properties` class [documentation](https://docs.oracle.com/javase/9/docs/api/java/util/Properties.html)
+- Java's `PropertyResourceBundle` [documentation](https://docs.oracle.com/javase/9/docs/api/java/util/PropertyResourceBundle.html)
+- Java's Internationalization [Guide](https://docs.oracle.com/en/java/javase/18/intl/internationalization-overview.html)
+- Wikipedia's .properties [page](https://en.wikipedia.org/wiki/.properties)
+
+### Special mention
+
+Thanks to [@calibr](https://github.com/calibr), the creator of [properties-file version 1.0](https://github.com/calibr/properties-file), for letting us use the [https://www.npmjs.com/package/properties-file](https://www.npmjs.com/package/properties-file) package name. We hope that it will make it easier to find our package.

package/dist/cjs/editor/index.d.ts

@@ -6,64 +6,88 @@ export type KeyValuePairSeparator = '=' | ':' | ' ';
 export type CommentDelimiter = '#' | '!';
 /** Options for {@link PropertiesEditor.insert}. */
 export type InsertOptions = {
-    /** Key to insert before or after. */
+    /**
+     * Insert relative to this key (last occurrence). If the key is not found,
+     * the property is appended at the end.
+     */
     referenceKey?: string;
     /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
-    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
     escapeUnicode?: boolean;
-    /** Separator character to use. Default: `'='`. */
+    /** Separator character to use between key and value. Default: `'='`. */
     separator?: KeyValuePairSeparator;
-    /** Comment text to prepend (without delimiter). */
+    /**
+     * Comment text to prepend before the property. Supports multi-line: newlines
+     * in the string create separate comment nodes. Empty lines within the text
+     * become blank line nodes.
+     */
     comment?: string;
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.insertComment}. */
 export type InsertCommentOptions = {
-    /** Key to insert before or after. */
+    /**
+     * Insert relative to this key (last occurrence). If the key is not found,
+     * the comment is appended at the end.
+     */
     referenceKey?: string;
     /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.insertBlankLine}. */
 export type InsertBlankLineOptions = {
-    /** Key to insert before or after. */
+    /**
+     * Insert relative to this key (last occurrence). If the key is not found,
+     * the blank line is appended at the end.
+     */
     referenceKey?: string;
     /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
 };
 /** Options for {@link PropertiesEditor.update}. */
 export type UpdateOptions = {
-    /** New value. */
+    /** Replacement value. When not set, the original value is preserved. */
     newValue?: string;
-    /** New key (rename). */
+    /** Replacement key (rename). When not set, the original key is preserved. */
     newKey?: string;
-    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
     escapeUnicode?: boolean;
-    /** New separator character. */
+    /** New separator character. When not set, the original separator is preserved. */
     separator?: KeyValuePairSeparator;
-    /** New comment text (replaces all leading comment nodes). */
+    /**
+     * Replacement comment text. When set, all comment and blank line nodes immediately
+     * preceding the property (up to the previous property) are removed and replaced
+     * with the new comment. Supports multi-line via newlines in the string.
+     */
     newComment?: string;
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the new comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.upsert}. */
 export type UpsertOptions = {
-    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
     escapeUnicode?: boolean;
     /** Separator character. Default: `'='`. */
     separator?: KeyValuePairSeparator;
-    /** Comment text for new properties. */
+    /**
+     * Comment text. When inserting a new property, this is prepended as a comment.
+     * When updating an existing property, this replaces the leading comment nodes.
+     */
     comment?: string;
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.delete}. */
 export type DeleteOptions = {
-    /** If `true`, also delete preceding comment and blank line nodes. Default: `true`. */
+    /**
+     * If `false`, only the property node itself is removed. If `true` (default),
+     * all comment and blank line nodes immediately preceding the property (up to
+     * the previous property) are also removed.
+     */
     deleteLeadingNodes?: boolean;
 };
 /**

package/dist/cjs/parser/nodes.d.ts

@@ -84,30 +84,73 @@ export type KeyCollisions = {
     /** All property nodes with this key, in file order. */
     nodes: PropertyNode[];
 };
-/** Options for {@link Properties.format} when producing normalized output. */
+/**
+ * Options for {@link Properties.format} when producing normalized output.
+ *
+ * When no options are passed to `format()`, the output is a lossless reconstruction
+ * of the original content. Passing any option triggers normalization, rebuilding
+ * property lines from their parsed fields.
+ */
 export type NormalizeOptions = {
-    /** End-of-line character to use. Defaults to the detected EOL from the source. */
+    /** Override the end-of-line character. Defaults to the EOL detected from the source. */
     endOfLineCharacter?: '\n' | '\r\n';
-    /** If `true`, remove all comment lines. Default: `false`. */
+    /** If `true`, remove all comment lines from the output. Default: `false`. */
     removeComments?: boolean;
-    /** If `true`, remove all blank lines. Default: `false`. */
+    /** If `true`, remove all blank lines from the output. Default: `false`. */
     removeBlankLines?: boolean;
-    /** If `true`, remove leading whitespace from all lines. Default: `false`. */
+    /** If `true`, strip leading whitespace from all property and comment lines. Default: `false`. */
     removeLeadingWhitespace?: boolean;
-    /** If `true`, keep only the last occurrence of each key. Default: `false`. */
+    /**
+     * If `true`, keep only the last occurrence of each duplicate key (Java's last-wins
+     * semantics). Earlier occurrences and their leading comment/blank line nodes are
+     * removed from the output. Set `deduplicateKeysKeepLeadingNodes` to `true` to
+     * preserve the leading nodes. Default: `false`.
+     */
     deduplicateKeys?: boolean;
-    /** Standardize the separator character. Original separators are preserved if not set. */
+    /**
+     * When `deduplicateKeys` is `true`, controls whether comment and blank line nodes
+     * preceding removed duplicates are preserved (`true`) or also removed (`false`).
+     * Default: `false` (leading nodes are removed along with the duplicate).
+     */
+    deduplicateKeysKeepLeadingNodes?: boolean;
+    /**
+     * Standardize the separator character across all properties. When set, every
+     * property is rewritten to use this separator. Original separators are preserved
+     * if not set. Use `' '` for whitespace-only separators (no `=` or `:`).
+     */
     separatorChar?: '=' | ':' | ' ';
-    /** Whitespace to place before the separator character. */
+    /**
+     * Whitespace to place before the separator character (e.g. `' '` for `key = value`,
+     * `''` for `key=value`). When not set, each property's original leading whitespace
+     * is preserved.
+     */
     separatorLeading?: string;
-    /** Whitespace to place after the separator character. */
+    /**
+     * Whitespace to place after the separator character (e.g. `' '` for `key = value`,
+     * `''` for `key=value`). When not set, each property's original trailing whitespace
+     * is preserved.
+     */
     separatorTrailing?: string;
-    /** If `true`, escape all non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
+    /**
+     * If `true`, re-escape all non-ASCII characters as `\\uXXXX` sequences. Useful for
+     * producing ISO-8859-1 compatible output. Default: `false` (preserves original encoding).
+     */
     escapeUnicode?: boolean;
-    /** If `true`, collapse multiline keys and values to single lines. Default: `false`. */
+    /**
+     * If `true`, collapse multiline keys and values (joined via `\\` line continuations)
+     * into single lines. Default: `false` (preserves original line structure).
+     */
     collapseMultiline?: boolean;
-    /** Wrap keys at this character width using line continuations. `undefined` = no wrapping. */
+    /**
+     * Wrap keys at this character width using `\\` line continuations. Only applies to
+     * keys longer than the specified width. `\\uXXXX` sequences are never split across
+     * lines. `undefined` = no wrapping.
+     */
     wrapKeysAt?: number;
-    /** Wrap values at this character width using line continuations. `undefined` = no wrapping. */
+    /**
+     * Wrap values at this character width using `\\` line continuations. Only applies to
+     * values longer than the specified width. `\\uXXXX` sequences are never split across
+     * lines. `undefined` = no wrapping.
+     */
     wrapValuesAt?: number;
 };

package/dist/cjs/parser/normalize.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"formatNormalized",{enumerable:!0,get:function(){return formatNormalized}});var _index=require("../escape/index.js"),BOM="\ufeff",wrapAtWidth=function(e,a){if(e.length<=a)return e;for(var r=[],i=0,t=e.length;i<t;){var o=Math.min(i+a,t);if(o<t)for(var n=0;n<6&&o-n>i;n++){var p=o-n;if(p+5<=t&&"\\"===e[p]&&"u"===e[p+1]){o=p;break}}r.push(e.slice(i,o)),i=o}return r.join("\\\n  ")},rebuildPropertyLine=function(e,a){var r,i,t,o,n=!0===a.escapeUnicode,p=a.removeLeadingWhitespace?"":e.leadingWhitespace,s=n?(0,_index.escapeKey)(e.key,!0):e.escapedKey;void 0!==a.separatorChar?(i=void 0!==a.separatorLeading?a.separatorLeading:e.separatorLeading,t=" "===a.separatorChar?"":a.separatorChar,o=void 0!==a.separatorTrailing?a.separatorTrailing:e.separatorTrailing," "===a.separatorChar&&(i=void 0!==a.separatorLeading?a.separatorLeading:" ")):(i=void 0!==a.separatorLeading?a.separatorLeading:e.separatorLeading,t=null!==(r=e.separatorChar)&&void 0!==r?r:"",o=void 0!==a.separatorTrailing?a.separatorTrailing:e.separatorTrailing);var d=n?(0,_index.escapeValue)(e.value,!0):e.escapedValue;return void 0!==a.wrapKeysAt&&a.wrapKeysAt>0&&(s=wrapAtWidth(s,a.wrapKeysAt)),void 0!==a.wrapValuesAt&&a.wrapValuesAt>0&&(d=wrapAtWidth(d,a.wrapValuesAt)),"".concat(p).concat(s).concat(i).concat(t).concat(o).concat(d)},formatNormalized=function(e,a,r,i){var t,o,n=null!==(t=i.endOfLineCharacter)&&void 0!==t?t:r,p=void 0!==i.separatorChar||void 0!==i.separatorLeading||void 0!==i.separatorTrailing||!0===i.escapeUnicode||!0===i.collapseMultiline||void 0!==i.wrapKeysAt||void 0!==i.wrapValuesAt||!0===i.removeLeadingWhitespace;if(i.deduplicateKeys){var s={};o={};for(var d=e.length-1;d>=0;d--){var c=e[d];"property"!==c.type||s[c.key]||(s[c.key]=!0,o[d]=!0)}}for(var l=[],u=0;u<e.length;u++){var v=e[u];switch(v.type){case"comment":if(i.removeComments)continue;l.push(i.removeLeadingWhitespace?"".concat(v.delimiter).concat(v.body):v.rawLine);break;case"blank":if(i.removeBlankLines)continue;l.push(v.rawLine);break;case"property":if(o&&!o[u])continue;p?l.push(rebuildPropertyLine(v,i)):l.push(v.rawLines.join(n))}}return(a?BOM:"")+l.join(n)};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"formatNormalized",{enumerable:!0,get:function(){return formatNormalized}});var _index=require("../escape/index.js"),BOM="\ufeff",wrapAtWidth=function(e,a){if(e.length<=a)return e;for(var r=[],i=0,t=e.length;i<t;){var o=Math.min(i+a,t);if(o<t)for(var n=0;n<6&&o-n>i;n++){var p=o-n;if(p+5<=t&&"\\"===e[p]&&"u"===e[p+1]){o=p;break}}r.push(e.slice(i,o)),i=o}return r.join("\\\n  ")},rebuildPropertyLine=function(e,a){var r,i,t,o,n=!0===a.escapeUnicode,p=a.removeLeadingWhitespace?"":e.leadingWhitespace,s=n?(0,_index.escapeKey)(e.key,!0):e.escapedKey;void 0!==a.separatorChar?(i=void 0!==a.separatorLeading?a.separatorLeading:e.separatorLeading,t=" "===a.separatorChar?"":a.separatorChar,o=void 0!==a.separatorTrailing?a.separatorTrailing:e.separatorTrailing," "===a.separatorChar&&(i=void 0!==a.separatorLeading?a.separatorLeading:" ")):(i=void 0!==a.separatorLeading?a.separatorLeading:e.separatorLeading,t=null!==(r=e.separatorChar)&&void 0!==r?r:"",o=void 0!==a.separatorTrailing?a.separatorTrailing:e.separatorTrailing);var d=n?(0,_index.escapeValue)(e.value,!0):e.escapedValue;return void 0!==a.wrapKeysAt&&a.wrapKeysAt>0&&(s=wrapAtWidth(s,a.wrapKeysAt)),void 0!==a.wrapValuesAt&&a.wrapValuesAt>0&&(d=wrapAtWidth(d,a.wrapValuesAt)),"".concat(p).concat(s).concat(i).concat(t).concat(o).concat(d)},formatNormalized=function(e,a,r,i){var t,o,n=null!==(t=i.endOfLineCharacter)&&void 0!==t?t:r,p=void 0!==i.separatorChar||void 0!==i.separatorLeading||void 0!==i.separatorTrailing||!0===i.escapeUnicode||!0===i.collapseMultiline||void 0!==i.wrapKeysAt||void 0!==i.wrapValuesAt||!0===i.removeLeadingWhitespace;if(i.deduplicateKeys){for(var s={},d=[],c=e.length-1;c>=0;c--){var l=e[c];"property"===l.type&&(s[l.key]?d.push(c):s[l.key]=!0)}o={};var u=!0,v=!1,f=void 0;try{for(var h,y=d[Symbol.iterator]();!(u=(h=y.next()).done);u=!0){var g=h.value;if(o[g]=!0,!i.deduplicateKeysKeepLeadingNodes)for(var L=g-1;L>=0&&"property"!==e[L].type;L--)o[L]=!0}}catch(e){v=!0,f=e}finally{try{u||null==y.return||y.return()}finally{if(v)throw f}}}for(var m=[],w=0;w<e.length;w++)if(!o||!o[w]){var b=e[w];switch(b.type){case"comment":if(i.removeComments)continue;m.push(i.removeLeadingWhitespace?"".concat(b.delimiter).concat(b.body):b.rawLine);break;case"blank":if(i.removeBlankLines)continue;m.push(b.rawLine);break;case"property":p?m.push(rebuildPropertyLine(b,i)):m.push(b.rawLines.join(n))}}return(a?BOM:"")+m.join(n)};

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

@@ -6,64 +6,88 @@ export type KeyValuePairSeparator = '=' | ':' | ' ';
 export type CommentDelimiter = '#' | '!';
 /** Options for {@link PropertiesEditor.insert}. */
 export type InsertOptions = {
-    /** Key to insert before or after. */
+    /**
+     * Insert relative to this key (last occurrence). If the key is not found,
+     * the property is appended at the end.
+     */
     referenceKey?: string;
     /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
-    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
     escapeUnicode?: boolean;
-    /** Separator character to use. Default: `'='`. */
+    /** Separator character to use between key and value. Default: `'='`. */
     separator?: KeyValuePairSeparator;
-    /** Comment text to prepend (without delimiter). */
+    /**
+     * Comment text to prepend before the property. Supports multi-line: newlines
+     * in the string create separate comment nodes. Empty lines within the text
+     * become blank line nodes.
+     */
     comment?: string;
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.insertComment}. */
 export type InsertCommentOptions = {
-    /** Key to insert before or after. */
+    /**
+     * Insert relative to this key (last occurrence). If the key is not found,
+     * the comment is appended at the end.
+     */
     referenceKey?: string;
     /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.insertBlankLine}. */
 export type InsertBlankLineOptions = {
-    /** Key to insert before or after. */
+    /**
+     * Insert relative to this key (last occurrence). If the key is not found,
+     * the blank line is appended at the end.
+     */
     referenceKey?: string;
     /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
 };
 /** Options for {@link PropertiesEditor.update}. */
 export type UpdateOptions = {
-    /** New value. */
+    /** Replacement value. When not set, the original value is preserved. */
     newValue?: string;
-    /** New key (rename). */
+    /** Replacement key (rename). When not set, the original key is preserved. */
     newKey?: string;
-    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
     escapeUnicode?: boolean;
-    /** New separator character. */
+    /** New separator character. When not set, the original separator is preserved. */
     separator?: KeyValuePairSeparator;
-    /** New comment text (replaces all leading comment nodes). */
+    /**
+     * Replacement comment text. When set, all comment and blank line nodes immediately
+     * preceding the property (up to the previous property) are removed and replaced
+     * with the new comment. Supports multi-line via newlines in the string.
+     */
     newComment?: string;
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the new comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.upsert}. */
 export type UpsertOptions = {
-    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
     escapeUnicode?: boolean;
     /** Separator character. Default: `'='`. */
     separator?: KeyValuePairSeparator;
-    /** Comment text for new properties. */
+    /**
+     * Comment text. When inserting a new property, this is prepended as a comment.
+     * When updating an existing property, this replaces the leading comment nodes.
+     */
     comment?: string;
-    /** Comment delimiter. Default: `'#'`. */
+    /** Delimiter character for the comment. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
 /** Options for {@link PropertiesEditor.delete}. */
 export type DeleteOptions = {
-    /** If `true`, also delete preceding comment and blank line nodes. Default: `true`. */
+    /**
+     * If `false`, only the property node itself is removed. If `true` (default),
+     * all comment and blank line nodes immediately preceding the property (up to
+     * the previous property) are also removed.
+     */
     deleteLeadingNodes?: boolean;
 };
 /**

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

@@ -84,30 +84,73 @@ export type KeyCollisions = {
     /** All property nodes with this key, in file order. */
     nodes: PropertyNode[];
 };
-/** Options for {@link Properties.format} when producing normalized output. */
+/**
+ * Options for {@link Properties.format} when producing normalized output.
+ *
+ * When no options are passed to `format()`, the output is a lossless reconstruction
+ * of the original content. Passing any option triggers normalization, rebuilding
+ * property lines from their parsed fields.
+ */
 export type NormalizeOptions = {
-    /** End-of-line character to use. Defaults to the detected EOL from the source. */
+    /** Override the end-of-line character. Defaults to the EOL detected from the source. */
     endOfLineCharacter?: '\n' | '\r\n';
-    /** If `true`, remove all comment lines. Default: `false`. */
+    /** If `true`, remove all comment lines from the output. Default: `false`. */
     removeComments?: boolean;
-    /** If `true`, remove all blank lines. Default: `false`. */
+    /** If `true`, remove all blank lines from the output. Default: `false`. */
     removeBlankLines?: boolean;
-    /** If `true`, remove leading whitespace from all lines. Default: `false`. */
+    /** If `true`, strip leading whitespace from all property and comment lines. Default: `false`. */
     removeLeadingWhitespace?: boolean;
-    /** If `true`, keep only the last occurrence of each key. Default: `false`. */
+    /**
+     * If `true`, keep only the last occurrence of each duplicate key (Java's last-wins
+     * semantics). Earlier occurrences and their leading comment/blank line nodes are
+     * removed from the output. Set `deduplicateKeysKeepLeadingNodes` to `true` to
+     * preserve the leading nodes. Default: `false`.
+     */
     deduplicateKeys?: boolean;
-    /** Standardize the separator character. Original separators are preserved if not set. */
+    /**
+     * When `deduplicateKeys` is `true`, controls whether comment and blank line nodes
+     * preceding removed duplicates are preserved (`true`) or also removed (`false`).
+     * Default: `false` (leading nodes are removed along with the duplicate).
+     */
+    deduplicateKeysKeepLeadingNodes?: boolean;
+    /**
+     * Standardize the separator character across all properties. When set, every
+     * property is rewritten to use this separator. Original separators are preserved
+     * if not set. Use `' '` for whitespace-only separators (no `=` or `:`).
+     */
     separatorChar?: '=' | ':' | ' ';
-    /** Whitespace to place before the separator character. */
+    /**
+     * Whitespace to place before the separator character (e.g. `' '` for `key = value`,
+     * `''` for `key=value`). When not set, each property's original leading whitespace
+     * is preserved.
+     */
     separatorLeading?: string;
-    /** Whitespace to place after the separator character. */
+    /**
+     * Whitespace to place after the separator character (e.g. `' '` for `key = value`,
+     * `''` for `key=value`). When not set, each property's original trailing whitespace
+     * is preserved.
+     */
     separatorTrailing?: string;
-    /** If `true`, escape all non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
+    /**
+     * If `true`, re-escape all non-ASCII characters as `\\uXXXX` sequences. Useful for
+     * producing ISO-8859-1 compatible output. Default: `false` (preserves original encoding).
+     */
     escapeUnicode?: boolean;
-    /** If `true`, collapse multiline keys and values to single lines. Default: `false`. */
+    /**
+     * If `true`, collapse multiline keys and values (joined via `\\` line continuations)
+     * into single lines. Default: `false` (preserves original line structure).
+     */
     collapseMultiline?: boolean;
-    /** Wrap keys at this character width using line continuations. `undefined` = no wrapping. */
+    /**
+     * Wrap keys at this character width using `\\` line continuations. Only applies to
+     * keys longer than the specified width. `\\uXXXX` sequences are never split across
+     * lines. `undefined` = no wrapping.
+     */
     wrapKeysAt?: number;
-    /** Wrap values at this character width using line continuations. `undefined` = no wrapping. */
+    /**
+     * Wrap values at this character width using `\\` line continuations. Only applies to
+     * values longer than the specified width. `\\uXXXX` sequences are never split across
+     * lines. `undefined` = no wrapping.
+     */
     wrapValuesAt?: number;
 };

package/dist/esm/parser/normalize.js

@@ -1 +1 @@
-import{escapeKey,escapeValue}from"../escape/index.js";var BOM="\ufeff",wrapAtWidth=function(a,e){if(a.length<=e)return a;for(var r=[],i=0,t=a.length;i<t;){var o=Math.min(i+e,t);if(o<t)for(var n=0;n<6&&o-n>i;n++){var p=o-n;if(p+5<=t&&"\\"===a[p]&&"u"===a[p+1]){o=p;break}}r.push(a.slice(i,o)),i=o}return r.join("\\\n  ")},rebuildPropertyLine=function(a,e){var r,i,t,o,n=!0===e.escapeUnicode,p=e.removeLeadingWhitespace?"":a.leadingWhitespace,s=n?escapeKey(a.key,!0):a.escapedKey;void 0!==e.separatorChar?(i=void 0!==e.separatorLeading?e.separatorLeading:a.separatorLeading,t=" "===e.separatorChar?"":e.separatorChar,o=void 0!==e.separatorTrailing?e.separatorTrailing:a.separatorTrailing," "===e.separatorChar&&(i=void 0!==e.separatorLeading?e.separatorLeading:" ")):(i=void 0!==e.separatorLeading?e.separatorLeading:a.separatorLeading,t=null!==(r=a.separatorChar)&&void 0!==r?r:"",o=void 0!==e.separatorTrailing?e.separatorTrailing:a.separatorTrailing);var c=n?escapeValue(a.value,!0):a.escapedValue;return void 0!==e.wrapKeysAt&&e.wrapKeysAt>0&&(s=wrapAtWidth(s,e.wrapKeysAt)),void 0!==e.wrapValuesAt&&e.wrapValuesAt>0&&(c=wrapAtWidth(c,e.wrapValuesAt)),"".concat(p).concat(s).concat(i).concat(t).concat(o).concat(c)};export var formatNormalized=function(a,e,r,i){var t,o,n=null!==(t=i.endOfLineCharacter)&&void 0!==t?t:r,p=void 0!==i.separatorChar||void 0!==i.separatorLeading||void 0!==i.separatorTrailing||!0===i.escapeUnicode||!0===i.collapseMultiline||void 0!==i.wrapKeysAt||void 0!==i.wrapValuesAt||!0===i.removeLeadingWhitespace;if(i.deduplicateKeys){var s={};o={};for(var c=a.length-1;c>=0;c--){var d=a[c];"property"!==d.type||s[d.key]||(s[d.key]=!0,o[c]=!0)}}for(var l=[],v=0;v<a.length;v++){var u=a[v];switch(u.type){case"comment":if(i.removeComments)continue;l.push(i.removeLeadingWhitespace?"".concat(u.delimiter).concat(u.body):u.rawLine);break;case"blank":if(i.removeBlankLines)continue;l.push(u.rawLine);break;case"property":if(o&&!o[v])continue;p?l.push(rebuildPropertyLine(u,i)):l.push(u.rawLines.join(n))}}return(e?BOM:"")+l.join(n)};
+import{escapeKey,escapeValue}from"../escape/index.js";var BOM="\ufeff",wrapAtWidth=function(e,a){if(e.length<=a)return e;for(var r=[],i=0,t=e.length;i<t;){var o=Math.min(i+a,t);if(o<t)for(var n=0;n<6&&o-n>i;n++){var p=o-n;if(p+5<=t&&"\\"===e[p]&&"u"===e[p+1]){o=p;break}}r.push(e.slice(i,o)),i=o}return r.join("\\\n  ")},rebuildPropertyLine=function(e,a){var r,i,t,o,n=!0===a.escapeUnicode,p=a.removeLeadingWhitespace?"":e.leadingWhitespace,s=n?escapeKey(e.key,!0):e.escapedKey;void 0!==a.separatorChar?(i=void 0!==a.separatorLeading?a.separatorLeading:e.separatorLeading,t=" "===a.separatorChar?"":a.separatorChar,o=void 0!==a.separatorTrailing?a.separatorTrailing:e.separatorTrailing," "===a.separatorChar&&(i=void 0!==a.separatorLeading?a.separatorLeading:" ")):(i=void 0!==a.separatorLeading?a.separatorLeading:e.separatorLeading,t=null!==(r=e.separatorChar)&&void 0!==r?r:"",o=void 0!==a.separatorTrailing?a.separatorTrailing:e.separatorTrailing);var d=n?escapeValue(e.value,!0):e.escapedValue;return void 0!==a.wrapKeysAt&&a.wrapKeysAt>0&&(s=wrapAtWidth(s,a.wrapKeysAt)),void 0!==a.wrapValuesAt&&a.wrapValuesAt>0&&(d=wrapAtWidth(d,a.wrapValuesAt)),"".concat(p).concat(s).concat(i).concat(t).concat(o).concat(d)};export var formatNormalized=function(e,a,r,i){var t,o,n=null!==(t=i.endOfLineCharacter)&&void 0!==t?t:r,p=void 0!==i.separatorChar||void 0!==i.separatorLeading||void 0!==i.separatorTrailing||!0===i.escapeUnicode||!0===i.collapseMultiline||void 0!==i.wrapKeysAt||void 0!==i.wrapValuesAt||!0===i.removeLeadingWhitespace;if(i.deduplicateKeys){for(var s={},d=[],c=e.length-1;c>=0;c--){var l=e[c];"property"===l.type&&(s[l.key]?d.push(c):s[l.key]=!0)}o={};var v=!0,u=!1,h=void 0;try{for(var f,y=d[Symbol.iterator]();!(v=(f=y.next()).done);v=!0){var g=f.value;if(o[g]=!0,!i.deduplicateKeysKeepLeadingNodes)for(var L=g-1;L>=0&&"property"!==e[L].type;L--)o[L]=!0}}catch(e){u=!0,h=e}finally{try{v||null==y.return||y.return()}finally{if(u)throw h}}}for(var m=[],w=0;w<e.length;w++)if(!o||!o[w]){var A=e[w];switch(A.type){case"comment":if(i.removeComments)continue;m.push(i.removeLeadingWhitespace?"".concat(A.delimiter).concat(A.body):A.rawLine);break;case"blank":if(i.removeBlankLines)continue;m.push(A.rawLine);break;case"property":p?m.push(rebuildPropertyLine(A,i)):m.push(A.rawLines.join(n))}}return(a?BOM:"")+m.join(n)};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "properties-file",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": ".properties file parser, editor, formatter and bundler integrations.",
   "keywords": [
     ".properties",