projen 0.103.4 → 0.103.6

package/node_modules/properties-file/dist/esm/editor/index.d.ts

@@ -0,0 +1,181 @@
+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 = '=' | ':' | ' ';
+/** Characters that can be used as comment delimiters. */
+export type CommentDelimiter = '#' | '!';
+/** Options for {@link PropertiesEditor.insert}. */
+export type InsertOptions = {
+    /**
+     * 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';
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
+    escapeUnicode?: boolean;
+    /** Separator character to use between key and value. Default: `'='`. */
+    separator?: KeyValuePairSeparator;
+    /**
+     * 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;
+    /** Delimiter character for the comment. Default: `'#'`. */
+    commentDelimiter?: CommentDelimiter;
+};
+/** Options for {@link PropertiesEditor.insertComment}. */
+export type InsertCommentOptions = {
+    /**
+     * 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';
+    /** Delimiter character for the comment. Default: `'#'`. */
+    commentDelimiter?: CommentDelimiter;
+};
+/** Options for {@link PropertiesEditor.insertBlankLine}. */
+export type InsertBlankLineOptions = {
+    /**
+     * 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 = {
+    /** Replacement value. When not set, the original value is preserved. */
+    newValue?: string;
+    /** Replacement key (rename). When not set, the original key is preserved. */
+    newKey?: string;
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
+    escapeUnicode?: boolean;
+    /** New separator character. When not set, the original separator is preserved. */
+    separator?: KeyValuePairSeparator;
+    /**
+     * 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;
+    /** Delimiter character for the new comment. Default: `'#'`. */
+    commentDelimiter?: CommentDelimiter;
+};
+/** Options for {@link PropertiesEditor.upsert}. */
+export type UpsertOptions = {
+    /** If `true`, escape non-ASCII characters as `\\uXXXX` sequences. Default: `false`. */
+    escapeUnicode?: boolean;
+    /** Separator character. Default: `'='`. */
+    separator?: KeyValuePairSeparator;
+    /**
+     * 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;
+    /** Delimiter character for the comment. Default: `'#'`. */
+    commentDelimiter?: CommentDelimiter;
+};
+/** Options for {@link PropertiesEditor.delete}. */
+export type DeleteOptions = {
+    /**
+     * 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;
+    /**
+     * Which occurrence of the key to delete when duplicates exist.
+     * - `'last'` (default) — deletes the last occurrence (the effective value in
+     *   Java's last-wins semantics).
+     * - `'first'` — deletes the first occurrence. Useful for cleaning up duplicate
+     *   keys while keeping the effective value.
+     */
+    occurrence?: 'first' | 'last';
+};
+/**
+ * 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 {
+    /**
+     * Find the first property node with the given key.
+     *
+     * @param key - The unescaped key to search for.
+     *
+     * @returns The matching node and its index in `this.nodes`, or `undefined`.
+     */
+    private findFirstProperty;
+    /**
+     * Find the last property node with the given key.
+     *
+     * @param key - The unescaped key to search for.
+     *
+     * @returns The matching node and its index in `this.nodes`, or `undefined`.
+     */
+    private findLastProperty;
+    /**
+     * Insert a new property.
+     *
+     * @param key - The unescaped key.
+     * @param value - The unescaped value.
+     * @param options - Insert options.
+     */
+    insert(key: string, value: string, options?: InsertOptions): void;
+    /**
+     * Insert a comment.
+     *
+     * @param comment - The comment text (may contain newlines).
+     * @param options - Insert comment options.
+     */
+    insertComment(comment: string, options?: InsertCommentOptions): void;
+    /**
+     * Insert a blank line.
+     *
+     * @param options - Insert blank line options.
+     */
+    insertBlankLine(options?: InsertBlankLineOptions): void;
+    /**
+     * Update an existing property.
+     *
+     * @param key - The unescaped key to update (uses last occurrence).
+     * @param options - Update options.
+     *
+     * @returns `true` if the property was found and updated, `false` otherwise.
+     */
+    update(key: string, options: UpdateOptions): boolean;
+    /**
+     * Update a property if it exists, or insert it if it doesn't.
+     *
+     * @param key - The unescaped key.
+     * @param value - The unescaped value.
+     * @param options - Upsert options.
+     */
+    upsert(key: string, value: string, options?: UpsertOptions): void;
+    /**
+     * Delete an occurrence of a property.
+     *
+     * By default, deletes the last occurrence (the effective value in Java's last-wins
+     * semantics). Use `{ occurrence: 'first' }` to delete the first occurrence instead,
+     * which is useful for cleaning up duplicate keys while keeping the effective value.
+     *
+     * @param key - The unescaped key to delete.
+     * @param options - Delete options.
+     *
+     * @returns The deleted {@link PropertyNode}, or `undefined` if the key was not found.
+     */
+    delete(key: string, options?: DeleteOptions): PropertyNode | undefined;
+    /**
+     * Delete all occurrences of a key.
+     *
+     * @param key - The unescaped key to delete.
+     *
+     * @returns An array of the deleted {@link PropertyNode} instances.
+     */
+    deleteAll(key: string): PropertyNode[];
+}

package/node_modules/properties-file/dist/esm/editor/index.js

@@ -0,0 +1 @@
+function _array_like_to_array(e,r){(null==r||r>e.length)&&(r=e.length);for(var t=0,n=new Array(r);t<r;t++)n[t]=e[t];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,r,t){return r=_get_prototype_of(r),_possible_constructor_return(e,_is_native_reflect_construct()?Reflect.construct(r,t||[],_get_prototype_of(e).constructor):r.apply(e,t))}function _class_call_check(e,r){if(!(e instanceof r))throw new TypeError("Cannot call a class as a function")}function _defineProperties(e,r){for(var t=0;t<r.length;t++){var n=r[t];n.enumerable=n.enumerable||!1,n.configurable=!0,"value"in n&&(n.writable=!0),Object.defineProperty(e,n.key,n)}}function _create_class(e,r,t){return r&&_defineProperties(e.prototype,r),t&&_defineProperties(e,t),e}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,r){if("function"!=typeof r&&null!==r)throw new TypeError("Super expression must either be null or a function");e.prototype=Object.create(r&&r.prototype,{constructor:{value:e,writable:!0,configurable:!0}}),r&&_set_prototype_of(e,r)}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})()}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,r){return!r||"object"!==_type_of(r)&&"function"!=typeof r?_assert_this_initialized(e):r}function _set_prototype_of(e,r){return _set_prototype_of=Object.setPrototypeOf||function(e,r){return e.__proto__=r,e},_set_prototype_of(e,r)}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,r){if(e){if("string"==typeof e)return _array_like_to_array(e,r);var t=Object.prototype.toString.call(e).slice(8,-1);return"Object"===t&&e.constructor&&(t=e.constructor.name),"Map"===t||"Set"===t?Array.from(t):"Arguments"===t||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?_array_like_to_array(e,r):void 0}}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,r,t,n){var o,a=!0===t.escapeUnicode,i=escapeKey(e,a),s=escapeValue(r,a),l=" "===t.separator?void 0:null!==(o=t.separator)&&void 0!==o?o:DEFAULT_SEPARATOR,c=l?" ":"",p=l?"".concat(" ").concat(l).concat(c):" ",u="".concat(i).concat(p).concat(s).split(REGEX_NEWLINE);return{type:"property",rawLines:u,leadingWhitespace:"",key:e,escapedKey:i,separatorLeading:" ",separatorChar:l,separatorTrailing:c,value:r,escapedValue:s,startingLineNumber:n,endingLineNumber:n+u.length-1}},buildCommentNodes=function(e,r,t){return e.split(REGEX_NEWLINE).map(function(e,n){return""===e?{type:"blank",rawLine:"",lineNumber:t+n}:{type:"comment",rawLine:"".concat(r," ").concat(e),leadingWhitespace:"",delimiter:r,body:" ".concat(e),lineNumber:t+n}})},recalculateLineNumbers=function(e){for(var r=1,t=0;t<e.length;t++){var n=e[t];if("property"===n.type){var o=n.rawLines.length;e[t]={type:"property",rawLines:n.rawLines,leadingWhitespace:n.leadingWhitespace,key:n.key,escapedKey:n.escapedKey,separatorLeading:n.separatorLeading,separatorChar:n.separatorChar,separatorTrailing:n.separatorTrailing,value:n.value,escapedValue:n.escapedValue,startingLineNumber:r,endingLineNumber:r+o-1},r+=o}else"comment"===n.type?(e[t]={type:"comment",rawLine:n.rawLine,leadingWhitespace:n.leadingWhitespace,delimiter:n.delimiter,body:n.body,lineNumber:r},r++):(e[t]={type:"blank",rawLine:n.rawLine,lineNumber:r},r++)}};export var PropertiesEditor=function(e){"use strict";function r(){return _class_call_check(this,r),_call_super(this,r,arguments)}return _inherits(r,e),_create_class(r,[{key:"findFirstProperty",value:function(e){for(var r=0;r<this.nodes.length;r++){var t=this.nodes[r];if("property"===t.type&&t.key===e)return{index:r,node:t}}}},{key:"findLastProperty",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{index:r,node:t}}}},{key:"insert",value:function(e,r,t){var n,o,a=[];if(void 0!==(null==t?void 0:t.comment)){var i,s=null!==(o=t.commentDelimiter)&&void 0!==o?o:DEFAULT_COMMENT_DELIMITER;(i=a).push.apply(i,_to_consumable_array(buildCommentNodes(t.comment,s,0)))}if(a.push(buildPropertyNode(e,r,{escapeUnicode:null==t?void 0:t.escapeUnicode,separator:null==t?void 0:t.separator},0)),null==t?void 0:t.referenceKey){var l=this.findLastProperty(t.referenceKey);if(void 0!==l){var c,p="before"===t.position?l.index:l.index+1;return(c=this.nodes).splice.apply(c,[p,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,r){var t,n,o=null!==(n=null==r?void 0:r.commentDelimiter)&&void 0!==n?n:DEFAULT_COMMENT_DELIMITER,a=buildCommentNodes(e,o,0);if(null==r?void 0:r.referenceKey){var i=this.findLastProperty(r.referenceKey);if(void 0!==i){var s,l="before"===r.position?i.index:i.index+1;return(s=this.nodes).splice.apply(s,[l,0].concat(_to_consumable_array(a))),void recalculateLineNumbers(this.nodes)}}(t=this.nodes).push.apply(t,_to_consumable_array(a)),recalculateLineNumbers(this.nodes)}},{key:"insertBlankLine",value:function(e){var r={type:"blank",rawLine:"",lineNumber:0};if(null==e?void 0:e.referenceKey){var t=this.findLastProperty(e.referenceKey);if(void 0!==t){var n="before"===e.position?t.index:t.index+1;return this.nodes.splice(n,0,r),void recalculateLineNumbers(this.nodes)}}this.nodes.push(r),recalculateLineNumbers(this.nodes)}},{key:"update",value:function(e,r){var t,n,o,a=this.findLastProperty(e);if(void 0===a)return!1;var i=a.index,s=a.node,l=null!==(t=r.newKey)&&void 0!==t?t:s.key,c=null!==(n=r.newValue)&&void 0!==n?n:s.value,p=!0===r.escapeUnicode,u=p?escapeKey(l,!0):void 0!==r.newKey?escapeKey(l):s.escapedKey,d=p?escapeValue(c,!0):void 0!==r.newValue?escapeValue(c):s.escapedValue,_=r.separator?" "===r.separator?void 0:r.separator:s.separatorChar,y=r.separator?" ":s.separatorLeading,f=r.separator?_?" ":"":s.separatorTrailing,m=_?"".concat(y).concat(_).concat(f):y,v="".concat(u).concat(m).concat(d).split(REGEX_NEWLINE),h={type:"property",rawLines:v,leadingWhitespace:s.leadingWhitespace,key:l,escapedKey:u,separatorLeading:y,separatorChar:_,separatorTrailing:f,value:c,escapedValue:d,startingLineNumber:s.startingLineNumber,endingLineNumber:s.startingLineNumber+v.length-1};if(void 0!==r.newComment){for(var b,L=i,g=i-1;g>=0&&"property"!==this.nodes[g].type;g--)L=g;var N=null!==(o=r.commentDelimiter)&&void 0!==o?o:DEFAULT_COMMENT_DELIMITER,E=buildCommentNodes(r.newComment,N,0);(b=this.nodes).splice.apply(b,[L,i-L+1].concat(_to_consumable_array(E),[h]))}else this.nodes[i]=h;return recalculateLineNumbers(this.nodes),!0}},{key:"upsert",value:function(e,r,t){void 0!==this.findLastProperty(e)?this.update(e,{newValue:r,escapeUnicode:null==t?void 0:t.escapeUnicode,separator:null==t?void 0:t.separator,newComment:null==t?void 0:t.comment,commentDelimiter:null==t?void 0:t.commentDelimiter}):this.insert(e,r,t)}},{key:"delete",value:function(e,r){var t="first"===(null==r?void 0:r.occurrence)?this.findFirstProperty(e):this.findLastProperty(e);if(void 0!==t){var n=t.index,o=t.node;if(!1!==(null==r?void 0:r.deleteLeadingNodes)){for(var a=n,i=n-1;i>=0&&"property"!==this.nodes[i].type;i--)a=i;this.nodes.splice(a,n-a+1)}else this.nodes.splice(n,1);return recalculateLineNumbers(this.nodes),o}}},{key:"deleteAll",value:function(e){for(var r=[],t=this.nodes.length-1;t>=0;t--){var n=this.nodes[t];"property"===n.type&&n.key===e&&(this.nodes.splice(t,1),r.push(n))}return r.length>0&&recalculateLineNumbers(this.nodes),r.reverse()}}]),r}(Properties);

package/node_modules/properties-file/dist/esm/escape/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Escape a property key.
+ *
+ * @param unescapedKey - A property key to be escaped.
+ * @param escapeUnicode - Escape unicode characters into ISO-8859-1 compatible encoding?
+ *
+ * @returns The escaped key.
+ */
+export declare const escapeKey: (unescapedKey: string, escapeUnicode?: boolean) => string;
+/**
+ * Escape property value.
+ *
+ * @param unescapedValue - Property value to be escaped.
+ * @param escapeUnicode - Escape unicode characters into ISO-8859-1 compatible encoding?
+ *
+ * @returns The escaped value.
+ */
+export declare const escapeValue: (unescapedValue: string, escapeUnicode?: boolean) => string;

package/node_modules/properties-file/dist/esm/escape/index.js

@@ -0,0 +1 @@
+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,t,r){var n=r?REGEX_ESCAPE_UNICODE:REGEX_ESCAPE_NO_UNICODE;return n.lastIndex=0,e.replace(n,function(e,r){switch(e){case" ":return t||0===r?"\\ ":" ";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"+e.charCodeAt(0).toString(16)).slice(-4)}})};

package/node_modules/properties-file/dist/esm/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A key-value pair object.
+ */
+export type KeyValuePairObject = Record<string, string>;
+/**
+ * Converts the content of a `.properties` file to a key-value pair object.
+ *
+ * This is a self-contained, zero-dependency parser optimized for minimal
+ * bundle size. It 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
+ *
+ * @param content - The content of a `.properties` file.
+ *
+ * @returns A key/value object representing the content of a `.properties` file.
+ */
+export declare const getProperties: (content: string | Buffer) => KeyValuePairObject;
+
+// Enables type recognition for direct `.properties` file imports.
+import './properties-file.d.ts'

package/node_modules/properties-file/dist/esm/index.js

@@ -0,0 +1 @@
+var _=function(e){return e>=48&&e<=57?e-48:e>=65&&e<=70?e-55:e>=97&&e<=102?e-87:-1},S=function(e){if(-1===e.indexOf("\\"))return e;for(var r=e.length,a="",c=0,t=0;t<r;)if(92===e.charCodeAt(t)){if(t>c&&(a+=e.slice(c,t)),++t>=r){a+="\\",c=t;break}switch(e.charCodeAt(t)){case 110:a+="\n",t++;break;case 116:a+="\t",t++;break;case 114:a+="\r",t++;break;case 102:a+="\f",t++;break;case 117:if(t+4>=r)throw new Error("malformed escaped unicode characters '".concat(e.slice(t-1,t+5),"'"));var o=_(e.charCodeAt(t+1)),i=_(e.charCodeAt(t+2)),n=_(e.charCodeAt(t+3)),f=_(e.charCodeAt(t+4));if(o<0||i<0||n<0||f<0)throw new Error("malformed escaped unicode characters '".concat(e.slice(t-1,t+5),"'"));a+=String.fromCharCode(o<<12|i<<8|n<<4|f),t+=5;break;default:a+=e.charAt(t),t++}c=t}else t++;return c<r&&(a+=e.slice(c,r)),a},H=function(e,r,a){for(;r<a;){var c=e.charCodeAt(r);if(32!==c&&9!==c&&12!==c)break;r++}return r},q=function(e){for(var r="string"==typeof e?e:e.toString(),a={},c=(r.length>0&&65279===r.charCodeAt(0)?r.slice(1):r).split(/\r\n|\r|\n/),t=c.length,o=0;o<t;){var i=c[o],n=i.length,f=H(i,0,n);if(f>=n)o++;else{var s=i.charCodeAt(f);if(35!==s&&33!==s){for(var d=0,h=n-1;h>=0&&92===i.charCodeAt(h);h--)d++;var l=d%2==1,v=void 0,C=void 0;if(l){var A=(f>0?i.slice(f):i).slice(0,-1),u=[A];for(C=-1!==A.indexOf("\\");l&&o+1<t;){var g=c[++o],b=g.length,k=H(g,0,b);d=0;for(var p=b-1;p>=k&&92===g.charCodeAt(p);p--)d++;var m=(l=d%2==1)?g.slice(k,b-1):g.slice(k);!C&&-1!==m.indexOf("\\")&&(C=!0),u.push(m)}v=u.join("")}else C=-1!==(v=f>0?i.slice(f):i).indexOf("\\");for(var w=v.length,x=0,_=!1;x<w;){var O=v.charCodeAt(x);if(92!==O){if(!_&&(61===O||58===O||32===O||9===O||12===O))break;_=!1,x++}else _=!_,x++}var q=x;if(q<w){var E=v.charCodeAt(q);(32===E||9===E||12===E)&&((q=H(v,q,w))<w&&(E=v.charCodeAt(q))),q<w&&(61===E||58===E)&&(q++,q=H(v,q,w))}var j=v.slice(0,x),y=v.slice(q);a[C?S(j):j]=C?S(y):y,o++}else o++}}return a};export{q as getProperties};

package/node_modules/properties-file/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/node_modules/properties-file/dist/esm/parser/index.js

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

package/node_modules/properties-file/dist/esm/parser/nodes.d.ts

@@ -0,0 +1,154 @@
+/** 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 = Record<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.
+ *
+ * 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 = {
+    /** Override the end-of-line character. Defaults to the EOL detected from the source. */
+    endOfLineCharacter?: '\n' | '\r\n';
+    /** If `true`, remove all comment lines from the output. Default: `false`. */
+    removeComments?: boolean;
+    /** If `true`, remove all blank lines from the output. Default: `false`. */
+    removeBlankLines?: boolean;
+    /** If `true`, strip leading whitespace from all property and comment lines. Default: `false`. */
+    removeLeadingWhitespace?: boolean;
+    /**
+     * 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;
+    /**
+     * 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 (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 (e.g. `' '` for `key = value`,
+     * `''` for `key=value`). When not set, each property's original trailing whitespace
+     * is preserved.
+     */
+    separatorTrailing?: string;
+    /**
+     * 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 (joined via `\\` line continuations)
+     * into single lines. Default: `false` (preserves original line structure).
+     */
+    collapseMultiline?: boolean;
+    /**
+     * 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. Only applies to
+     * values longer than the specified width. `\\uXXXX` sequences are never split across
+     * lines. `undefined` = no wrapping.
+     */
+    wrapValuesAt?: number;
+};

package/node_modules/properties-file/dist/esm/parser/nodes.js

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

package/node_modules/properties-file/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/node_modules/properties-file/dist/esm/parser/normalize.js

@@ -0,0 +1 @@
+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,p=!0===a.escapeUnicode,s=a.removeLeadingWhitespace?"":e.leadingWhitespace,c=p?escapeKey(e.key,!0):e.escapedKey,d=null!==(r=a.separatorLeading)&&void 0!==r?r:e.separatorLeading,l=null!==(i=a.separatorTrailing)&&void 0!==i?i:e.separatorTrailing;void 0!==a.separatorChar?(n=" "===a.separatorChar?"":a.separatorChar," "===a.separatorChar&&(d=null!==(t=a.separatorLeading)&&void 0!==t?t:" ")):n=null!==(o=e.separatorChar)&&void 0!==o?o:"";var u=p?escapeValue(e.value,!0):e.escapedValue;return void 0!==a.wrapKeysAt&&a.wrapKeysAt>0&&(c=wrapAtWidth(c,a.wrapKeysAt)),void 0!==a.wrapValuesAt&&a.wrapValuesAt>0&&(u=wrapAtWidth(u,a.wrapValuesAt)),"".concat(s).concat(c).concat(d).concat(n).concat(l).concat(u)};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={},c=[],d=e.length-1;d>=0;d--){var l=e[d];"property"===l.type&&(s[l.key]?c.push(d):s[l.key]=!0)}o={};for(var u=0;u<c.length;u++){var v=c[u];if(o[v]=!0,!i.deduplicateKeysKeepLeadingNodes)for(var h=v-1;h>=0&&"property"!==e[h].type;h--)o[h]=!0}}for(var f=[],y=0;y<e.length;y++)if(!(null==o?void 0:o[y])){var g=e[y];switch(g.type){case"comment":if(i.removeComments)continue;f.push(i.removeLeadingWhitespace?"".concat(g.delimiter).concat(g.body):g.rawLine);break;case"blank":if(i.removeBlankLines)continue;f.push(g.rawLine);break;case"property":p?f.push(rebuildPropertyLine(g,i)):f.push(g.rawLines.join(n))}}return(a?BOM:"")+f.join(n)};

package/node_modules/properties-file/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/node_modules/properties-file/dist/esm/parser/parse.js

@@ -0,0 +1 @@
+import{CH_BACKSLASH,CH_BANG,CH_BOM,CH_COLON,CH_CR,CH_EQUALS,CH_FF,CH_HASH,CH_LF,CH_SPACE,CH_TAB}from"../characters.js";import{unescapeContent}from"../unescape/index.js";var 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 t="\n",n=i;n<a;n++){var C=r.charCodeAt(n);if(C===CH_CR){t=n+1<a&&r.charCodeAt(n+1)===CH_LF?"\r\n":"\r";break}if(C===CH_LF){t="\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 m=c[++l];d.push(m);var B=m.length;S=(L=countTrailingBackslashes(m,B))%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 j=N.charCodeAt(Q);if(j!==CH_BACKSLASH){if(!U&&(j===CH_EQUALS||j===CH_COLON||isWhitespace(j)))break;U=!1,Q++}else U=!U,Q++}var w=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!==w.indexOf("\\")?unescapeContent(w):w,escapedKey:w,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:t,nodes:o}};

package/node_modules/properties-file/dist/esm/parser/properties.d.ts

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

package/node_modules/properties-file/dist/esm/parser/properties.js

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

package/node_modules/properties-file/dist/esm/properties-file.d.ts

@@ -0,0 +1,8 @@
+declare module '*.properties' {
+  /** A key/value object representing the content of a `.properties` file. */
+  const properties: {
+    /** The value of a `.properties` file key. */
+    [key: string]: string
+  }
+  export { properties }
+}

package/node_modules/properties-file/dist/esm/unescape/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ *
+ * @throws Error if malformed escaped unicode characters are present.
+ */
+export declare const unescapeContent: (content: string) => string;

package/node_modules/properties-file/dist/esm/unescape/index.js

@@ -0,0 +1 @@
+import{CH_BACKSLASH,CH_LOWER_F,CH_LOWER_N,CH_LOWER_R,CH_LOWER_T,CH_LOWER_U}from"../characters.js";var hexValue=function(e){return e>=48&&e<=57?e-48:e>=65&&e<=70?e-55:e>=97&&e<=102?e-87:-1};export var unescapeContent=function(e){if(-1===e.indexOf("\\"))return e;for(var r=e.length,a="",c=0,t=0;t<r;)if(e.charCodeAt(t)===CH_BACKSLASH){if(t>c&&(a+=e.slice(c,t)),++t>=r){a+="\\",c=t;break}switch(e.charCodeAt(t)){case CH_LOWER_N:a+="\n",t++;break;case CH_LOWER_T:a+="\t",t++;break;case CH_LOWER_R:a+="\r",t++;break;case CH_LOWER_F:a+="\f",t++;break;case CH_LOWER_U:if(t+4>=r)throw new Error("malformed escaped unicode characters '".concat(e.slice(t-1,t+5),"'"));var o=hexValue(e.charCodeAt(t+1)),C=hexValue(e.charCodeAt(t+2)),_=hexValue(e.charCodeAt(t+3)),h=hexValue(e.charCodeAt(t+4));if(o<0||C<0||_<0||h<0)throw new Error("malformed escaped unicode characters '".concat(e.slice(t-1,t+5),"'"));a+=String.fromCharCode(o<<12|C<<8|_<<4|h),t+=5;break;default:a+=e.charAt(t),t++}c=t}else t++;return c<r&&(a+=e.slice(c,r)),a};