properties-file 3.7.0 → 5.0.0

package/dist/cjs/parser/properties.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"Properties",{enumerable:!0,get:function(){return Properties}});var _normalize=require("./normalize.js"),_parse=require("./parse.js");function _instanceof(e,r){return null!=r&&"undefined"!=typeof Symbol&&r[Symbol.hasInstance]?!!r[Symbol.hasInstance](e):e instanceof r}function _class_call_check(e,r){if(!_instanceof(e,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}var BOM="\ufeff",Properties=function(){function e(r){_class_call_check(this,e);var t=(0,_parse.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 s=[],l=!0,u=!1,f=void 0;try{for(var y,c=Object.keys(e)[Symbol.iterator]();!(l=(y=c.next()).done);l=!0){var p=y.value;e[p].length>1&&s.push({key:p,nodes:e[p]})}}catch(e){u=!0,f=e}finally{try{l||null==c.return||c.return()}finally{if(u)throw f}}return s}},{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,s=this.nodes[Symbol.iterator]();!(n=(i=s.next()).done);n=!0){var l=i.value;"property"===l.type?t.push(l.rawLines.join(r)):t.push(l.rawLine)}}catch(e){o=!0,a=e}finally{try{n||null==s.return||s.return()}finally{if(o)throw a}}return(this.hasBom?BOM:"")+t.join(r)}return(0,_normalize.formatNormalized)(this.nodes,this.hasBom,this.eolCharacter,e)}}]),e}();

package/dist/cjs/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/cjs/unescape/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.unescapeContent=void 0;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"},unescapeContent=function(e){var n;if(-1===e.indexOf("\\"))return e;var r=e.match(REGEX_INVALID_UNICODE_ESCAPE);if(r){var t=null!==(n=r.index)&&void 0!==n?n:0,E=e.slice(t,t+6);throw new Error("malformed escaped unicode characters '".concat(E,"'"))}return e.replace(REGEX_ESCAPE,function(e,n,r,t){return n?ESCAPE_MAP[n]:r?String.fromCharCode(parseInt(r,16)):null!=t?t:""})};exports.unescapeContent=unescapeContent;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"unescapeContent",{enumerable:!0,get:function(){return unescapeContent}});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},unescapeContent=function(e){if(-1===e.indexOf("\\"))return e;for(var r=e.length,t="",a=0,c=0;c<r;)if(e.charCodeAt(c)===CH_BACKSLASH){if(c>a&&(t+=e.slice(a,c)),++c>=r){t+="\\",a=c;break}switch(e.charCodeAt(c)){case CH_LOWER_N:t+="\n",c++;break;case CH_LOWER_T:t+="\t",c++;break;case CH_LOWER_R:t+="\r",c++;break;case CH_LOWER_F:t+="\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 n=hexValue(e.charCodeAt(c+1))<<12|hexValue(e.charCodeAt(c+2))<<8|hexValue(e.charCodeAt(c+3))<<4|hexValue(e.charCodeAt(c+4));t+=String.fromCharCode(n),c+=5;break;default:t+=e.charAt(c),c++}a=c}else c++;return a<r&&(t+=e.slice(a,r)),t};

package/dist/esm/bundler/bun.d.ts

@@ -0,0 +1,10 @@
+import type { BunPlugin } from 'bun';
+/**
+ * Bun plugin for `.properties` files. Works with both `Bun.plugin` (runtime) and `Bun.build`
+ * (build-time).
+ */
+declare const bunPlugin: BunPlugin;
+export default bunPlugin;
+
+// Enables type recognition for direct `.properties` file imports.
+import '../properties-file.d.ts'

package/dist/esm/bundler/bun.js

@@ -0,0 +1 @@
+import{readFileSync}from"node:fs";import{getProperties}from"../index.js";var bunPlugin={name:"properties-file",setup:function(e){e.onLoad({filter:/\.properties$/},function(e){var r=e.path;return{exports:{properties:getProperties(readFileSync(r,"utf8"))},loader:"object"}})}};export default bunPlugin;

package/dist/esm/bundler/esbuild.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'esbuild';
+/**
+ * esbuild plugin for `.properties` files.
+ *
+ * @returns An esbuild plugin that transforms `.properties` imports into JavaScript modules.
+ */
+declare const esbuildPlugin: () => Plugin;
+export default esbuildPlugin;
+
+// Enables type recognition for direct `.properties` file imports.
+import '../properties-file.d.ts'

package/dist/esm/bundler/esbuild.js

@@ -0,0 +1 @@
+import{readFileSync}from"node:fs";import{getProperties}from"../index.js";var esbuildPlugin=function(){return{name:"properties-file",setup:function(e){e.onLoad({filter:/\.properties$/},function(e){var r=e.path;return{contents:"export const properties = ".concat(JSON.stringify(getProperties(readFileSync(r,"utf8"))),";"),loader:"js"}})}}};export default esbuildPlugin;

package/dist/esm/bundler/rollup.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'rollup';
+/**
+ * Rollup plugin for `.properties` files. Also compatible with Vite and Rolldown.
+ *
+ * @returns A Rollup plugin that transforms `.properties` imports into JavaScript modules.
+ */
+declare const rollupPlugin: () => Plugin;
+export default rollupPlugin;
+
+// Enables type recognition for direct `.properties` file imports.
+import '../properties-file.d.ts'

package/dist/esm/bundler/rollup.js

@@ -0,0 +1 @@
+import{getProperties}from"../index.js";var PROPERTIES_EXTENSION=".properties",rollupPlugin=function(){return{name:"properties-file",transform:function(e,r){return-1===r.indexOf(PROPERTIES_EXTENSION,r.length-PROPERTIES_EXTENSION.length)?null:{code:"export const properties = ".concat(JSON.stringify(getProperties(e)),";"),map:null}}}};export default rollupPlugin;

package/dist/esm/bundler/webpack.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Webpack file loader for `.properties` files. Also compatible with Rspack.
+ *
+ * @param content - The content of a `.properties` file.
+ *
+ * @returns A CommonJS module string exporting the parsed key-value pairs.
+ */
+declare const webpackLoader: (content: string) => string;
+export default webpackLoader;
+
+// Enables type recognition for direct `.properties` file imports.
+import '../properties-file.d.ts'

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

@@ -1,154 +1,137 @@
-import { KeyValuePairObject } from '../index.js';
-import { Properties } from '../properties.js';
-/** The default separator between keys and values. */
-export declare const DEFAULT_SEPARATOR = "=";
-/** The default character used as comment delimiter. */
-export declare const DEFAULT_COMMENT_DELIMITER = "#";
+import { Properties } from '../parser/properties.js';
+import type { PropertyNode } from '../parser/nodes.js';
 /** Characters that can be used as key-value pair separators. */
-export type KeyValuePairSeparator = ' ' | ':' | '=';
+export type KeyValuePairSeparator = '=' | ':' | ' ';
 /** Characters that can be used as comment delimiters. */
 export type CommentDelimiter = '#' | '!';
-/** Options on the `Properties.insert` method. */
+/** Options for {@link PropertiesEditor.insert}. */
 export type InsertOptions = {
-    /** The name of the key to insert before or after. If the key not found, the new property will not be inserted. */
+    /** Key to insert before or after. */
     referenceKey?: string;
-    /** The position of the insertion related to the `referenceKey` (default is `after`) */
+    /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
-    /** Escape unicode characters into ISO-8859-1 compatible encoding? */
+    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
     escapeUnicode?: boolean;
-    /** The key/value separator character. */
+    /** Separator character to use. Default: `'='`. */
     separator?: KeyValuePairSeparator;
-    /** A comment to insert before. */
+    /** Comment text to prepend (without delimiter). */
     comment?: string;
-    /** The comment's delimiter. */
+    /** Comment delimiter. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
-/** Options on the `Properties.insertComment` method. */
+/** Options for {@link PropertiesEditor.insertComment}. */
 export type InsertCommentOptions = {
-    /** The name of the key to insert before or after. If the key not found, the new property will not be inserted. */
+    /** Key to insert before or after. */
     referenceKey?: string;
-    /** The position of the insertion related to the `referenceKey` (default is `after`) */
+    /** Position relative to the reference key. Default: `'after'`. */
     position?: 'before' | 'after';
-    /** The comment's delimiter. */
+    /** Comment delimiter. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
-/** Options on the `Properties.update` method. */
+/** Options for {@link PropertiesEditor.insertBlankLine}. */
+export type InsertBlankLineOptions = {
+    /** Key to insert before or after. */
+    referenceKey?: string;
+    /** Position relative to the reference key. Default: `'after'`. */
+    position?: 'before' | 'after';
+};
+/** Options for {@link PropertiesEditor.update}. */
 export type UpdateOptions = {
-    /** Optionally replace the existing value with a new value. */
+    /** New value. */
     newValue?: string;
-    /** Optionally replace the existing key with a new key name. */
+    /** New key (rename). */
     newKey?: string;
-    /** Escape unicode characters into ISO-8859-1 compatible encoding? */
+    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
     escapeUnicode?: boolean;
-    /** A key/value separator character. */
-    separator?: ' ' | ':' | '=';
-    /** Optionally insert a new comment, or replace the existing one (including white-space characters). */
+    /** New separator character. */
+    separator?: KeyValuePairSeparator;
+    /** New comment text (replaces all leading comment nodes). */
     newComment?: string;
-    /** The comment's delimiter. */
+    /** Comment delimiter. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
-/** Options on the `Properties.upsert` method. */
+/** Options for {@link PropertiesEditor.upsert}. */
 export type UpsertOptions = {
-    /** Escape unicode characters into ISO-8859-1 compatible encoding? */
+    /** Escape non-ASCII characters as `\\uXXXX`. Default: `false`. */
     escapeUnicode?: boolean;
-    /** The key/value separator character. */
+    /** Separator character. Default: `'='`. */
     separator?: KeyValuePairSeparator;
-    /** A comment to insert before. */
+    /** Comment text for new properties. */
     comment?: string;
-    /** The comment's delimiter. */
+    /** Comment delimiter. Default: `'#'`. */
     commentDelimiter?: CommentDelimiter;
 };
+/** Options for {@link PropertiesEditor.delete}. */
+export type DeleteOptions = {
+    /** If `true`, also delete preceding comment and blank line nodes. Default: `true`. */
+    deleteLeadingNodes?: boolean;
+};
 /**
- * A .properties file editor.
+ * An editor for `.properties` files that extends the lossless {@link Properties}
+ * parser with insert, update, delete, and upsert operations.
  */
 export declare class PropertiesEditor extends Properties {
-    /** Is line parsing required to re-async the object's properties? */
-    private needsLineParsing;
     /**
-     * Create `PropertiesEditor` object.
+     * Find the index of the last property node with the given key.
      *
-     * @param content - The content of a `.properties` file.
-     */
-    constructor(content: string);
-    /**
-     * Find the last occurrence of a property by key (iterates backward for performance).
+     * @param key - The unescaped key to search for.
      *
-     * @param key - The property key to search for.
-     *
-     * @returns The last matching property, or undefined if not found.
+     * @returns The index in `this.nodes`, or `-1` if not found.
      */
-    private findLastPropertyByKey;
+    private findLastPropertyIndex;
     /**
-     * Parse the `.properties` content line by line only when needed.
-     */
-    private parseLinesIfNeeded;
-    /**
-     * Insert a new property in the existing object (by default it will be at the end).
-     *
-     * @param key - A property key (unescaped).
-     * @param value - A property value (unescaped).
-     * @param options - Additional options.
+     * Insert a new property.
      *
-     * @returns True if the key was inserted, otherwise false.
+     * @param key - The unescaped key.
+     * @param value - The unescaped value.
+     * @param options - Insert options.
      */
-    insert(key: string, value: string, options?: InsertOptions): boolean;
+    insert(key: string, value: string, options?: InsertOptions): void;
     /**
-     * Insert a new comment in the existing object (by default it will be at the end).
+     * Insert a comment.
      *
-     * @param comment - The comment to add.
-     * @param options - Additional options.
-     *
-     * @returns True if the comment was inserted, otherwise false.
+     * @param comment - The comment text (may contain newlines).
+     * @param options - Insert comment options.
      */
-    insertComment(comment: string, options?: InsertCommentOptions): boolean;
+    insertComment(comment: string, options?: InsertCommentOptions): void;
     /**
-     * Delete the last occurrence of a given key from the existing object.
-     *
-     * @param key - The name of the key to delete.
-     * @param deleteCommentsAndWhiteSpace - By default, comments and white-space characters before the key will be deleted.
+     * Insert a blank line.
      *
-     * @returns True if the key was deleted, otherwise false.
+     * @param options - Insert blank line options.
      */
-    delete(key: string, deleteCommentsAndWhiteSpace?: boolean): boolean;
+    insertBlankLine(options?: InsertBlankLineOptions): void;
     /**
-     * Restore the original newline characters of a key.
+     * Update an existing property.
      *
-     * @param property - A property object.
+     * @param key - The unescaped key to update (uses last occurrence).
+     * @param options - Update options.
      *
-     * @returns The key with its original newlines characters restored.
+     * @returns `true` if the property was found and updated, `false` otherwise.
      */
-    private getKeyWithNewlines;
+    update(key: string, options: UpdateOptions): boolean;
     /**
-     * Restore the original newline characters of a value.
+     * Update a property if it exists, or insert it if it doesn't.
      *
-     * @param property - A property object.
-     *
-     * @returns The value with its original newlines characters restored.
+     * @param key - The unescaped key.
+     * @param value - The unescaped value.
+     * @param options - Upsert options.
      */
-    private getValueWithNewlines;
+    upsert(key: string, value: string, options?: UpsertOptions): void;
     /**
-     * Update the last occurrence of a given key from the existing object.
+     * Delete the last occurrence of a property (the effective value in last-wins semantics).
      *
-     * @param key - The name of the key to update.
-     * @param options - Additional options.
+     * @param key - The unescaped key to delete.
+     * @param options - Delete options.
      *
-     * @returns True if the key was updated, otherwise false.
+     * @returns The deleted {@link PropertyNode}, or `undefined` if the key was not found.
      */
-    update(key: string, options?: UpdateOptions): boolean;
+    delete(key: string, options?: DeleteOptions): PropertyNode | undefined;
     /**
-     * Update a key if it exist, otherwise add it at the end.
-     *
-     * @param key - A property key (unescaped).
-     * @param value - A property value (unescaped).
-     * @param options - Additional options.
+     * Delete all occurrences of a key.
      *
-     * @returns True if the key was updated or inserted, otherwise false.
-     */
-    upsert(key: string, value: string, options?: UpsertOptions): boolean;
-    /**
-     * Get the key/value object representing the properties.
+     * @param key - The unescaped key to delete.
      *
-     * @returns A key/value object representing the properties.
+     * @returns An array of the deleted {@link PropertyNode} instances.
      */
-    toObject(): KeyValuePairObject;
+    deleteAll(key: string): PropertyNode[];
 }

package/dist/esm/editor/index.js

@@ -1 +1 @@
-var __extends=this&&this.__extends||function(){var e=function(n,r){return e=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(e,n){e.__proto__=n}||function(e,n){for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])},e(n,r)};return function(n,r){if("function"!=typeof r&&null!==r)throw new TypeError("Class extends value "+String(r)+" is not a constructor or null");function t(){this.constructor=n}e(n,r),n.prototype=null===r?Object.create(r):(t.prototype=r.prototype,new t)}}(),__read=this&&this.__read||function(e,n){var r="function"==typeof Symbol&&e[Symbol.iterator];if(!r)return e;var t,i,o=r.call(e),a=[];try{for(;(void 0===n||n-- >0)&&!(t=o.next()).done;)a.push(t.value)}catch(e){i={error:e}}finally{try{t&&!t.done&&(r=o.return)&&r.call(o)}finally{if(i)throw i.error}}return a},__spreadArray=this&&this.__spreadArray||function(e,n,r){if(r||2===arguments.length)for(var t,i=0,o=n.length;i<o;i++)!t&&i in n||(t||(t=Array.prototype.slice.call(n,0,i)),t[i]=n[i]);return e.concat(t||Array.prototype.slice.call(n))};import{escapeKey,escapeValue}from"../escape/index.js";import{Properties,REGEX_NEWLINE}from"../properties.js";var REGEX_NEWLINE_GLOBAL=/\r?\n/g,REGEX_LF=/\n/;export var DEFAULT_SEPARATOR="=";export var DEFAULT_COMMENT_DELIMITER="#";var PropertiesEditor=function(e){function n(n){var r=e.call(this,n)||this;return r.needsLineParsing=!1,r}return __extends(n,e),n.prototype.findLastPropertyByKey=function(e){for(var n=this.collection.length-1;n>=0;n--){var r=this.collection[n];if(r.key===e)return r}},n.prototype.parseLinesIfNeeded=function(){this.needsLineParsing&&(this.parseLines(),this.needsLineParsing=!1)},n.prototype.insert=function(e,n,r){var t,i,o,a=(null==r?void 0:r.escapeUnicode)||!1,s=(null==r?void 0:r.separator)?" "===r.separator?" ":" ".concat(r.separator," "):" ".concat(DEFAULT_SEPARATOR," ").replace("  "," "),c=null==r?void 0:r.referenceKey,l=(null==r?void 0:r.position)||"after";c&&this.parseLinesIfNeeded();var p=e.split(REGEX_NEWLINE).map(function(e){return escapeKey(e,a)}).join("\\\n"),d=n.split(REGEX_NEWLINE).map(function(e){return escapeValue(e,a)}).join("\\\n"),u="".concat((null==r?void 0:r.commentDelimiter)||DEFAULT_COMMENT_DELIMITER," "),_=void 0===(null==r?void 0:r.comment)?"":"".concat("".concat(u).concat(r.comment).split(REGEX_NEWLINE).join("\n".concat(u)),"\n"),y="".concat(_).concat(p).concat(s).concat(d).split(REGEX_LF);if(void 0===c)return(t=this.lines).push.apply(t,__spreadArray([],__read(y),!1)),this.needsLineParsing=!0,!0;var v=this.findLastPropertyByKey(c);if(v){var f="after"===l?v.endingLineNumber:null!==(o=null===(i=v.previousProperty)||void 0===i?void 0:i.endingLineNumber)&&void 0!==o?o:0;return this.lines=__spreadArray(__spreadArray(__spreadArray([],__read(this.lines.slice(0,f)),!1),__read(y),!1),__read(this.lines.slice(f)),!1),this.needsLineParsing=!0,!0}return!1},n.prototype.insertComment=function(e,n){var r,t,i,o=null==n?void 0:n.referenceKey,a=(null==n?void 0:n.position)||"after";o&&this.parseLinesIfNeeded();var s="".concat((null==n?void 0:n.commentDelimiter)||DEFAULT_COMMENT_DELIMITER," "),c="".concat(s).concat(e).replace(REGEX_NEWLINE_GLOBAL,"\n".concat(s)).split(REGEX_LF);if(void 0===o)return(r=this.lines).push.apply(r,__spreadArray([],__read(c),!1)),this.needsLineParsing=!0,!0;var l=this.findLastPropertyByKey(o);if(l){var p="after"===a?l.endingLineNumber:null!==(i=null===(t=l.previousProperty)||void 0===t?void 0:t.endingLineNumber)&&void 0!==i?i:0;return this.lines=__spreadArray(__spreadArray(__spreadArray([],__read(this.lines.slice(0,p)),!1),__read(c),!1),__read(this.lines.slice(p)),!1),this.needsLineParsing=!0,!0}return!1},n.prototype.delete=function(e,n){var r,t;void 0===n&&(n=!0),this.parseLinesIfNeeded();var i=this.findLastPropertyByKey(e);if(i){var o=n?null!==(t=null===(r=i.previousProperty)||void 0===r?void 0:r.endingLineNumber)&&void 0!==t?t:0:i.startingLineNumber-1,a=i.endingLineNumber;return this.lines=__spreadArray(__spreadArray([],__read(this.lines.slice(0,o)),!1),__read(this.lines.slice(a)),!1),this.needsLineParsing=!0,!0}return!1},n.prototype.getKeyWithNewlines=function(e){return 0===e.newlinePositions.length?e.key:__spreadArray([],__read(e.key),!1).reduce(function(n,r,t){return"".concat(n).concat(-1!==e.newlinePositions.indexOf(t)?"\n":"").concat(r)},"")},n.prototype.getValueWithNewlines=function(e){return 0===e.newlinePositions.length||void 0===e.valuePosition?e.value:__spreadArray([],__read(e.value),!1).reduce(function(n,r,t){return"".concat(n).concat(-1!==e.newlinePositions.indexOf(t+e.valuePosition)?"\n":"").concat(r)},"")},n.prototype.update=function(e,n){var r,t,i,o;this.parseLinesIfNeeded();var a=this.findLastPropertyByKey(e);if(!a||!n)return!1;var s=n.escapeUnicode||!1,c=n.separator?" "===n.separator?" ":" ".concat(n.separator," "):a.separator||" ".concat(DEFAULT_SEPARATOR," ").replace("  "," "),l=(null!==(r=n.newKey)&&void 0!==r?r:this.getKeyWithNewlines(a)).split(REGEX_NEWLINE).map(function(e){return escapeKey(e,s)}).join("\\\n"),p=(null!==(t=n.newValue)&&void 0!==t?t:this.getValueWithNewlines(a)).split(REGEX_NEWLINE).map(function(e){return escapeValue(e,s)}).join("\\\n"),d="".concat(n.commentDelimiter||DEFAULT_COMMENT_DELIMITER," "),u=void 0===n.newComment?"":"".concat("".concat(d).concat(n.newComment).split(REGEX_NEWLINE).join("\n".concat(d)),"\n"),_="".concat(u).concat(l).concat(c).concat(p).split(REGEX_LF);return this.lines=__spreadArray(__spreadArray(__spreadArray([],__read(this.lines.slice(0,void 0===n.newComment?a.startingLineNumber-1:null!==(o=null===(i=a.previousProperty)||void 0===i?void 0:i.endingLineNumber)&&void 0!==o?o:0)),!1),__read(_),!1),__read(this.lines.slice(a.endingLineNumber)),!1),this.needsLineParsing=!0,!0},n.prototype.upsert=function(e,n,r){return this.parseLinesIfNeeded(),this.keyLineNumbers[e]?this.update(e,{newValue:n,newComment:null==r?void 0:r.comment,commentDelimiter:null==r?void 0:r.commentDelimiter,separator:null==r?void 0:r.separator,escapeUnicode:null==r?void 0:r.escapeUnicode}):this.insert(e,n,r)},n.prototype.toObject=function(){return this.parseLinesIfNeeded(),e.prototype.toObject.call(this)},n}(Properties);export{PropertiesEditor};
+function _array_like_to_array(e,t){(null==t||t>e.length)&&(t=e.length);for(var r=0,n=new Array(t);r<t;r++)n[r]=e[r];return n}function _array_without_holes(e){if(Array.isArray(e))return _array_like_to_array(e)}function _assert_this_initialized(e){if(void 0===e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return e}function _call_super(e,t,r){return t=_get_prototype_of(t),_possible_constructor_return(e,_is_native_reflect_construct()?Reflect.construct(t,r||[],_get_prototype_of(e).constructor):t.apply(e,r))}function _class_call_check(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,t){for(var r=0;r<t.length;r++){var n=t[r];n.enumerable=n.enumerable||!1,n.configurable=!0,"value"in n&&(n.writable=!0),Object.defineProperty(e,n.key,n)}}function _create_class(e,t,r){return t&&_defineProperties(e.prototype,t),r&&_defineProperties(e,r),e}function _get_prototype_of(e){return _get_prototype_of=Object.setPrototypeOf?Object.getPrototypeOf:function(e){return e.__proto__||Object.getPrototypeOf(e)},_get_prototype_of(e)}function _inherits(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function");e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,writable:!0,configurable:!0}}),t&&_set_prototype_of(e,t)}function _iterable_to_array(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function _non_iterable_spread(){throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function _possible_constructor_return(e,t){return!t||"object"!==_type_of(t)&&"function"!=typeof t?_assert_this_initialized(e):t}function _set_prototype_of(e,t){return _set_prototype_of=Object.setPrototypeOf||function(e,t){return e.__proto__=t,e},_set_prototype_of(e,t)}function _to_consumable_array(e){return _array_without_holes(e)||_iterable_to_array(e)||_unsupported_iterable_to_array(e)||_non_iterable_spread()}function _type_of(e){return e&&"undefined"!=typeof Symbol&&e.constructor===Symbol?"symbol":typeof e}function _unsupported_iterable_to_array(e,t){if(e){if("string"==typeof e)return _array_like_to_array(e,t);var r=Object.prototype.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(r):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?_array_like_to_array(e,t):void 0}}function _is_native_reflect_construct(){try{var e=!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}))}catch(e){}return(_is_native_reflect_construct=function(){return!!e})()}import{escapeKey,escapeValue}from"../escape/index.js";import{Properties}from"../parser/properties.js";var DEFAULT_SEPARATOR="=",DEFAULT_COMMENT_DELIMITER="#",REGEX_NEWLINE=/\r\n|\r|\n/,buildPropertyNode=function(e,t,r,n){var o,a=!0===r.escapeUnicode,i=escapeKey(e,a),s=escapeValue(t,a),l=" "===r.separator?void 0:null!==(o=r.separator)&&void 0!==o?o:DEFAULT_SEPARATOR,c=l?" ":"",u=l?"".concat(" ").concat(l).concat(c):" ",p="".concat(i).concat(u).concat(s).split(REGEX_NEWLINE);return{type:"property",rawLines:p,leadingWhitespace:"",key:e,escapedKey:i,separatorLeading:" ",separatorChar:l,separatorTrailing:c,value:t,escapedValue:s,startingLineNumber:n,endingLineNumber:n+p.length-1}},buildCommentNodes=function(e,t,r){return e.split(REGEX_NEWLINE).map(function(e,n){return""===e?{type:"blank",rawLine:"",lineNumber:r+n}:{type:"comment",rawLine:"".concat(t," ").concat(e),leadingWhitespace:"",delimiter:t,body:" ".concat(e),lineNumber:r+n}})},recalculateLineNumbers=function(e){var t=1,r=!0,n=!1,o=void 0;try{for(var a,i=e[Symbol.iterator]();!(r=(a=i.next()).done);r=!0){var s=a.value;if("property"===s.type){var l=s.rawLines.length;s.startingLineNumber=t,s.endingLineNumber=t+l-1,t+=l}else s.lineNumber=t,t++}}catch(e){n=!0,o=e}finally{try{r||null==i.return||i.return()}finally{if(n)throw o}}};export var PropertiesEditor=function(e){"use strict";function t(){return _class_call_check(this,t),_call_super(this,t,arguments)}return _inherits(t,e),_create_class(t,[{key:"findLastPropertyIndex",value:function(e){for(var t=this.nodes.length-1;t>=0;t--){var r=this.nodes[t];if("property"===r.type&&r.key===e)return t}return-1}},{key:"insert",value:function(e,t,r){var n,o,a=[];if(void 0!==(null==r?void 0:r.comment)){var i,s=null!==(o=r.commentDelimiter)&&void 0!==o?o:DEFAULT_COMMENT_DELIMITER;(i=a).push.apply(i,_to_consumable_array(buildCommentNodes(r.comment,s,0)))}if(a.push(buildPropertyNode(e,t,{escapeUnicode:null==r?void 0:r.escapeUnicode,separator:null==r?void 0:r.separator},0)),null==r?void 0:r.referenceKey){var l=this.findLastPropertyIndex(r.referenceKey);if(-1!==l){var c,u="before"===r.position?l:l+1;return(c=this.nodes).splice.apply(c,[u,0].concat(_to_consumable_array(a))),void recalculateLineNumbers(this.nodes)}}(n=this.nodes).push.apply(n,_to_consumable_array(a)),recalculateLineNumbers(this.nodes)}},{key:"insertComment",value:function(e,t){var r,n,o=null!==(n=null==t?void 0:t.commentDelimiter)&&void 0!==n?n:DEFAULT_COMMENT_DELIMITER,a=buildCommentNodes(e,o,0);if(null==t?void 0:t.referenceKey){var i=this.findLastPropertyIndex(t.referenceKey);if(-1!==i){var s,l="before"===t.position?i:i+1;return(s=this.nodes).splice.apply(s,[l,0].concat(_to_consumable_array(a))),void recalculateLineNumbers(this.nodes)}}(r=this.nodes).push.apply(r,_to_consumable_array(a)),recalculateLineNumbers(this.nodes)}},{key:"insertBlankLine",value:function(e){var t={type:"blank",rawLine:"",lineNumber:0};if(null==e?void 0:e.referenceKey){var r=this.findLastPropertyIndex(e.referenceKey);if(-1!==r){var n="before"===e.position?r:r+1;return this.nodes.splice(n,0,t),void recalculateLineNumbers(this.nodes)}}this.nodes.push(t),recalculateLineNumbers(this.nodes)}},{key:"update",value:function(e,t){var r,n,o,a=this.findLastPropertyIndex(e);if(-1===a)return!1;var i=this.nodes[a],s=null!==(r=t.newKey)&&void 0!==r?r:i.key,l=null!==(n=t.newValue)&&void 0!==n?n:i.value,c=!0===t.escapeUnicode,u=c?escapeKey(s,!0):void 0!==t.newKey?escapeKey(s):i.escapedKey,p=c?escapeValue(l,!0):void 0!==t.newValue?escapeValue(l):i.escapedValue,_=t.separator?" "===t.separator?void 0:t.separator:i.separatorChar,d=t.separator?" ":i.separatorLeading,y=t.separator?_?" ":"":i.separatorTrailing,f=_?"".concat(d).concat(_).concat(y):d,m="".concat(u).concat(f).concat(p).split(REGEX_NEWLINE),v={type:"property",rawLines:m,leadingWhitespace:i.leadingWhitespace,key:s,escapedKey:u,separatorLeading:d,separatorChar:_,separatorTrailing:y,value:l,escapedValue:p,startingLineNumber:i.startingLineNumber,endingLineNumber:i.startingLineNumber+m.length-1};if(void 0!==t.newComment){for(var h,b=a,L=a-1;L>=0&&"property"!==this.nodes[L].type;L--)b=L;var E=null!==(o=t.commentDelimiter)&&void 0!==o?o:DEFAULT_COMMENT_DELIMITER,N=buildCommentNodes(t.newComment,E,0);(h=this.nodes).splice.apply(h,[b,a-b+1].concat(_to_consumable_array(N),[v]))}else this.nodes[a]=v;return recalculateLineNumbers(this.nodes),!0}},{key:"upsert",value:function(e,t,r){-1!==this.findLastPropertyIndex(e)?this.update(e,{newValue:t,escapeUnicode:null==r?void 0:r.escapeUnicode,separator:null==r?void 0:r.separator,newComment:null==r?void 0:r.comment,commentDelimiter:null==r?void 0:r.commentDelimiter}):this.insert(e,t,r)}},{key:"delete",value:function(e,t){var r=this.findLastPropertyIndex(e);if(-1!==r){var n=this.nodes[r];if(!1!==(null==t?void 0:t.deleteLeadingNodes)){for(var o=r,a=r-1;a>=0&&"property"!==this.nodes[a].type;a--)o=a;this.nodes.splice(o,r-o+1)}else this.nodes.splice(r,1);return recalculateLineNumbers(this.nodes),n}}},{key:"deleteAll",value:function(e){for(var t=[],r=this.nodes.length-1;r>=0;r--){var n=this.nodes[r];"property"===n.type&&n.key===e&&(this.nodes.splice(r,1),t.push(n))}return t.length>0&&recalculateLineNumbers(this.nodes),t.reverse()}}]),t}(Properties);

package/dist/esm/escape/index.js

@@ -1 +1 @@
-export var escapeKey=function(e,r){return void 0===r&&(r=!1),escapeContent(e,!0,r)};export var escapeValue=function(e,r){return void 0===r&&(r=!1),escapeContent(e,!1,r)};var escapeContent=function(e,r,n){return e.replace(new RegExp("[\\s!#:=\\\\".concat(n?"\0--￿":"","]"),"g"),function(e,n){var t;switch(e){case" ":return r||0===n?"\\ ":" ";case"\\":return"\\\\";case"\f":return"\\f";case"\n":return"\\n";case"\r":return"\\r";case"\t":return"\\t";case"=":case":":case"#":case"!":return"\\".concat(e);default:return"\\u"+("0000"+(null!==(t=e.charCodeAt(0))&&void 0!==t?t:0).toString(16)).slice(-4)}})};
+export var escapeKey=function(e){return escapeContent(e,!0,arguments.length>1&&void 0!==arguments[1]&&arguments[1])};export var escapeValue=function(e){return escapeContent(e,!1,arguments.length>1&&void 0!==arguments[1]&&arguments[1])};var REGEX_ESCAPE_NO_UNICODE=/[\s!#:=\\]/g,REGEX_ESCAPE_UNICODE=/[\s!#:=\\\u0000-\u001F\u007F-\uFFFF]/g,escapeContent=function(e,r,t){var n=t?REGEX_ESCAPE_UNICODE:REGEX_ESCAPE_NO_UNICODE;return n.lastIndex=0,e.replace(n,function(e,t){var n;switch(e){case" ":return r||0===t?"\\ ":" ";case"\\":return"\\\\";case"\f":return"\\f";case"\n":return"\\n";case"\r":return"\\r";case"\t":return"\\t";case"=":case":":case"#":case"!":return"\\".concat(e);default:return"\\u"+("0000"+(null!==(n=e.charCodeAt(0))&&void 0!==n?n:0).toString(16)).slice(-4)}})};

package/dist/esm/index.d.ts

@@ -1,4 +1,3 @@
-export { Properties } from './properties.js';
 /**
  * A key-value pair object.
  */

package/dist/esm/index.js

@@ -1 +1 @@
-import{Properties}from"./properties.js";export{Properties}from"./properties.js";export var getProperties=function(r){return new Properties(r).toObject()};
+import{parseProperties}from"./parse-properties.js";export var getProperties=function(r){return parseProperties(r)};

package/dist/esm/parse-properties.d.ts

@@ -0,0 +1,22 @@
+import type { KeyValuePairObject } from './index.js';
+/**
+ * Parse a `.properties` file content string into a key-value pair object.
+ *
+ * This is a functional, single-pass parser that implements the Java
+ * `java.util.Properties` specification:
+ *
+ * - BOM detection and skipping
+ * - Comment lines (`#` or `!`)
+ * - Line continuations (trailing odd backslash)
+ * - Key-value separator detection (`=`, `:`, or whitespace)
+ * - Escape sequence processing (`\\n`, `\\t`, `\\r`, `\\f`, `\\\\`, `\\uXXXX`)
+ * - Last-value-wins semantics for duplicate keys
+ *
+ * All character inspection uses `charCodeAt()` (ES5). No regex, no
+ * intermediate object allocations.
+ *
+ * @param content - The content of a `.properties` file (string or Buffer).
+ *
+ * @returns A key-value pair object where every value is a string.
+ */
+export declare const parseProperties: (content: string | Buffer) => KeyValuePairObject;

package/dist/esm/parse-properties.js

@@ -0,0 +1 @@
+var CH_TAB=9,CH_LF=10,CH_FF=12,CH_CR=13,CH_SPACE=32,CH_BANG=33,CH_HASH=35,CH_COLON=58,CH_EQUALS=61,CH_BACKSLASH=92,CH_LOWER_F=102,CH_LOWER_N=110,CH_LOWER_R=114,CH_LOWER_T=116,CH_LOWER_U=117,CH_BOM=65279,skipWhitespace=function(e,C,r){for(;C<r;){var a=e.charCodeAt(C);if(a!==CH_SPACE&&a!==CH_TAB&&a!==CH_FF)break;C++}return C},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},unescapeContent=function(e,C,r,a,t){if(!a)return e.slice(C,r);for(var H="",_=C,c=C;c<r;)if(e.charCodeAt(c)===CH_BACKSLASH){switch(c>_&&(H+=e.slice(_,c)),c++,e.charCodeAt(c)){case CH_LOWER_N:H+="\n",c++;break;case CH_LOWER_T:H+="\t",c++;break;case CH_LOWER_R:H+="\r",c++;break;case CH_LOWER_F:H+="\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,"' in property starting at line ").concat(t))}var A=hexValue(e.charCodeAt(c+1))<<12|hexValue(e.charCodeAt(c+2))<<8|hexValue(e.charCodeAt(c+3))<<4|hexValue(e.charCodeAt(c+4));H+=String.fromCharCode(A),c+=5;break;default:H+=e.charAt(c),c++}_=c}else c++;return _<r&&(H+=e.slice(_,r)),H};export var parseProperties=function(e){var C="string"==typeof e?e:e.toString(),r=C.length,a={},t=0,H=1;for(r>0&&C.charCodeAt(0)===CH_BOM&&(t=1);t<r&&!((t=skipWhitespace(C,t,r))>=r);){var _=C.charCodeAt(t);if(_!==CH_LF)if(_!==CH_CR)if(_!==CH_HASH&&_!==CH_BANG){for(var c=H,i=t,A=0,o=!1;t<r&&(_=C.charCodeAt(t))!==CH_LF&&_!==CH_CR;)_===CH_BACKSLASH?(A++,o=!0):A=0,t++;if(A%2==1){var s=[C.slice(i,t-1)],h=o;for(t<r&&(C.charCodeAt(t)===CH_CR?++t<r&&C.charCodeAt(t)===CH_LF&&t++:t++,H++),t=skipWhitespace(C,t,r);;){var n=t;A=0;for(var L=!1;t<r&&(_=C.charCodeAt(t))!==CH_LF&&_!==CH_CR;)_===CH_BACKSLASH?(A++,L=!0):A=0,t++;var d=A%2==1,f=d?t-1:t;if(s.push(C.slice(n,f)),L&&(h=!0),t<r&&(C.charCodeAt(t)===CH_CR?++t<r&&C.charCodeAt(t)===CH_LF&&t++:t++,H++),!d)break;t=skipWhitespace(C,t,r)}for(var p=s.join(""),S=p.length,u=0,F=!1;u<S;)if((_=p.charCodeAt(u))!==CH_BACKSLASH){if(!F&&(_===CH_EQUALS||_===CH_COLON||_===CH_SPACE||_===CH_TAB||_===CH_FF))break;F=!1,u++}else F=!F,u++;var l=u;l<S&&((_=p.charCodeAt(l))!==CH_SPACE&&_!==CH_TAB&&_!==CH_FF||(l=skipWhitespace(p,l,S))<S&&(_=p.charCodeAt(l)),l<S&&(_===CH_EQUALS||_===CH_COLON)&&(l++,l=skipWhitespace(p,l,S))),a[unescapeContent(p,0,u,h,c)]=unescapeContent(p,l,S,h,c)}else{var E=t;t<r&&(C.charCodeAt(t)===CH_CR?++t<r&&C.charCodeAt(t)===CH_LF&&t++:t++,H++);for(var O=i,R=!1;O<E;)if((_=C.charCodeAt(O))!==CH_BACKSLASH){if(!R&&(_===CH_EQUALS||_===CH_COLON||_===CH_SPACE||_===CH_TAB||_===CH_FF))break;R=!1,O++}else R=!R,O++;var k=O;k<E&&((_=C.charCodeAt(k))!==CH_SPACE&&_!==CH_TAB&&_!==CH_FF||(k=skipWhitespace(C,k,E))<E&&(_=C.charCodeAt(k)),k<E&&(_===CH_EQUALS||_===CH_COLON)&&(k++,k=skipWhitespace(C,k,E))),a[unescapeContent(C,i,O,o,c)]=unescapeContent(C,k,E,o,c)}}else for(;t<r;){if((_=C.charCodeAt(t))===CH_LF){t++,H++;break}if(_===CH_CR){++t<r&&C.charCodeAt(t)===CH_LF&&t++,H++;break}t++}else++t<r&&C.charCodeAt(t)===CH_LF&&t++,H++;else t++,H++}return a};

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

@@ -0,0 +1,3 @@
+export { Properties } from './properties.js';
+export { PropertiesNodeType } from './nodes.js';
+export type { BlankLineNode, CommentNode, KeyCollisions, KeyValuePairObject, NormalizeOptions, PropertiesNode, PropertyNode, } from './nodes.js';

package/dist/esm/parser/index.js

@@ -0,0 +1 @@
+export{Properties}from"./properties.js";export{PropertiesNodeType}from"./nodes.js";

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

@@ -0,0 +1,113 @@
+/** Constants for the `type` discriminator on each node. */
+export declare const PropertiesNodeType: {
+    /** A property (key-value pair). */
+    readonly PROPERTY: "property";
+    /** A comment line (`#` or `!`). */
+    readonly COMMENT: "comment";
+    /** A blank line. */
+    readonly BLANK: "blank";
+};
+/**
+ * A property (key-value pair), potentially spanning multiple physical lines
+ * via backslash continuation.
+ */
+export type PropertyNode = {
+    /** Discriminator. */
+    readonly type: 'property';
+    /** Physical lines as-is (without EOL characters), for lossless reconstruction. */
+    readonly rawLines: string[];
+    /** Leading whitespace before the key on the first physical line. */
+    readonly leadingWhitespace: string;
+    /** The unescaped key. */
+    readonly key: string;
+    /** The key as written in the source (after continuation joining, before unescaping). */
+    readonly escapedKey: string;
+    /** Whitespace between the key and the separator character. */
+    readonly separatorLeading: string;
+    /**
+     * The core separator character.
+     *
+     * - `'='` or `':'` when an explicit delimiter is used.
+     * - `undefined` when whitespace alone separates key from value, or when
+     *   the property is key-only with no separator.
+     */
+    readonly separatorChar: '=' | ':' | undefined;
+    /** Whitespace between the separator character and the value. */
+    readonly separatorTrailing: string;
+    /** The unescaped value. */
+    readonly value: string;
+    /** The value as written in the source (after continuation joining, before unescaping). */
+    readonly escapedValue: string;
+    /** 1-based line number where this property starts. */
+    readonly startingLineNumber: number;
+    /** 1-based line number where this property ends. */
+    readonly endingLineNumber: number;
+};
+/**
+ * A comment line starting with `#` or `!`.
+ */
+export type CommentNode = {
+    /** Discriminator. */
+    readonly type: 'comment';
+    /** The full line as-is (without the EOL character). */
+    readonly rawLine: string;
+    /** Leading whitespace before the delimiter. */
+    readonly leadingWhitespace: string;
+    /** The comment delimiter character. */
+    readonly delimiter: '#' | '!';
+    /** The text after the delimiter (including any space immediately after it). */
+    readonly body: string;
+    /** 1-based line number. */
+    readonly lineNumber: number;
+};
+/**
+ * A blank line (may contain only whitespace characters).
+ */
+export type BlankLineNode = {
+    /** Discriminator. */
+    readonly type: 'blank';
+    /** The raw whitespace content of the line (without the EOL character). */
+    readonly rawLine: string;
+    /** 1-based line number. */
+    readonly lineNumber: number;
+};
+/** Discriminated union of all node types in a `.properties` file. */
+export type PropertiesNode = PropertyNode | CommentNode | BlankLineNode;
+/** A plain key-value pair object where every value is a string. */
+export type KeyValuePairObject = {
+    [key: string]: string;
+};
+/** Information about a key that appears more than once. */
+export type KeyCollisions = {
+    /** The duplicate key. */
+    key: string;
+    /** All property nodes with this key, in file order. */
+    nodes: PropertyNode[];
+};
+/** Options for {@link Properties.format} when producing normalized output. */
+export type NormalizeOptions = {
+    /** End-of-line character to use. Defaults to the detected EOL from the source. */
+    endOfLineCharacter?: '\n' | '\r\n';
+    /** If `true`, remove all comment lines. Default: `false`. */
+    removeComments?: boolean;
+    /** If `true`, remove all blank lines. Default: `false`. */
+    removeBlankLines?: boolean;
+    /** If `true`, remove leading whitespace from all lines. Default: `false`. */
+    removeLeadingWhitespace?: boolean;
+    /** If `true`, keep only the last occurrence of each key. Default: `false`. */
+    deduplicateKeys?: boolean;
+    /** Standardize the separator character. Original separators are preserved if not set. */
+    separatorChar?: '=' | ':' | ' ';
+    /** Whitespace to place before the separator character. */
+    separatorLeading?: string;
+    /** Whitespace to place after the separator character. */
+    separatorTrailing?: string;
+    /** If `true`, escape all non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
+    escapeUnicode?: boolean;
+    /** If `true`, collapse multiline keys and values to single lines. Default: `false`. */
+    collapseMultiline?: boolean;
+    /** Wrap keys at this character width using line continuations. `undefined` = no wrapping. */
+    wrapKeysAt?: number;
+    /** Wrap values at this character width using line continuations. `undefined` = no wrapping. */
+    wrapValuesAt?: number;
+};

package/dist/esm/parser/nodes.js

@@ -0,0 +1 @@
+export var PropertiesNodeType={PROPERTY:"property",COMMENT:"comment",BLANK:"blank"};

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

@@ -0,0 +1,12 @@
+import type { NormalizeOptions, PropertiesNode } from './nodes.js';
+/**
+ * Format a set of property nodes into normalized output.
+ *
+ * @param nodes - All nodes from the parsed document.
+ * @param hasBom - Whether the original content had a BOM.
+ * @param eolCharacter - The detected EOL character.
+ * @param options - Normalization options.
+ *
+ * @returns The normalized `.properties` file content.
+ */
+export declare const formatNormalized: (nodes: PropertiesNode[], hasBom: boolean, eolCharacter: string, options: NormalizeOptions) => string;

package/dist/esm/parser/normalize.js

@@ -0,0 +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)};

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

@@ -0,0 +1,23 @@
+import type { PropertiesNode } from './nodes.js';
+/** Result of parsing a `.properties` file. */
+export type ParseResult = {
+    /** Whether the content starts with a BOM character. */
+    hasBom: boolean;
+    /** The detected end-of-line character sequence. */
+    eolCharacter: string;
+    /** All parsed nodes in file order. */
+    nodes: PropertiesNode[];
+};
+/**
+ * Parse a `.properties` file into a lossless sequence of nodes.
+ *
+ * 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 by joining node raw lines with the EOL
+ * character.
+ *
+ * @param content - The content of a `.properties` file.
+ *
+ * @returns The parse result with BOM info, detected EOL, and ordered nodes.
+ */
+export declare const parseDocument: (content: string | Buffer) => ParseResult;

package/dist/esm/parser/parse.js

@@ -0,0 +1 @@
+import{unescapeContent}from"../unescape/index.js";var CH_TAB=9,CH_LF=10,CH_FF=12,CH_CR=13,CH_SPACE=32,CH_BANG=33,CH_HASH=35,CH_COLON=58,CH_EQUALS=61,CH_BACKSLASH=92,CH_BOM=65279,isWhitespace=function(e){return e===CH_SPACE||e===CH_TAB||e===CH_FF},countTrailingBackslashes=function(e,r){for(var a=0,i=r-1;i>=0&&e.charCodeAt(i)===CH_BACKSLASH;)a++,i--;return a};export var parseDocument=function(e){var r="string"==typeof e?e:e.toString(),a=r.length,i=0,s=a>0&&r.charCodeAt(0)===CH_BOM;s&&(i=1);for(var n="\n",t=i;t<a;t++){var C=r.charCodeAt(t);if(C===CH_CR){n=t+1<a&&r.charCodeAt(t+1)===CH_LF?"\r\n":"\r";break}if(C===CH_LF){n="\n";break}}for(var c=(i>0?r.slice(i):r).split(/\r\n|\r|\n/),o=[],l=0,h=c.length;l<h;){for(var H=c[l],p=l+1,v=0,A=H.length;v<A&&isWhitespace(H.charCodeAt(v));)v++;if(v>=A){var f={type:"blank",rawLine:H,lineNumber:p};o.push(f),l++}else{var _=H.charCodeAt(v);if(_!==CH_HASH&&_!==CH_BANG){for(var d=[H],u=p,g=v>0?H.slice(0,v):"",L=countTrailingBackslashes(H,A),S=L%2==1;S&&l+1<h;){var B=c[++l];d.push(B);var m=B.length;S=(L=countTrailingBackslashes(B,m))%2==1}var O=l+1,b=S,N=void 0;if(1===d.length){var k=v>0?H.slice(v):H;N=b?k.slice(0,-1):k}else{for(var y=[],W=0;W<d.length;W++){var F=d[W],E=void 0,T=void 0;if(0===W)E=v,T=F.length-1;else{E=0;for(var x=F.length;E<x&&isWhitespace(F.charCodeAt(E));)E++;T=W===d.length-1&&!b?x:x-1}y.push(F.slice(E,T))}N=y.join("")}for(var K=N.length,Q=0,U=!1;Q<K;){var w=N.charCodeAt(Q);if(w!==CH_BACKSLASH){if(!U&&(w===CH_EQUALS||w===CH_COLON||isWhitespace(w)))break;U=!1,Q++}else U=!U,Q++}var j=N.slice(0,Q),G="",M=void 0,P="",R=Q;if(R<K){for(var D=R;R<K&&isWhitespace(N.charCodeAt(R));)R++;if(R<K){var V=N.charCodeAt(R);if(V===CH_EQUALS||V===CH_COLON){G=N.slice(D,R),M=V===CH_EQUALS?"=":":";for(var q=++R;R<K&&isWhitespace(N.charCodeAt(R));)R++;P=N.slice(q,R)}else G=N.slice(D,R)}else G=N.slice(D,R)}var z=N.slice(R),I={type:"property",rawLines:d,leadingWhitespace:g,key:-1!==j.indexOf("\\")?unescapeContent(j):j,escapedKey:j,separatorLeading:G,separatorChar:M,separatorTrailing:P,value:-1!==z.indexOf("\\")?unescapeContent(z):z,escapedValue:z,startingLineNumber:u,endingLineNumber:O};o.push(I),l++}else{var J={type:"comment",rawLine:H,leadingWhitespace:v>0?H.slice(0,v):"",delimiter:_===CH_HASH?"#":"!",body:H.slice(v+1),lineNumber:p};o.push(J),l++}}}return{hasBom:s,eolCharacter:n,nodes:o}};