projen 0.103.3 → 0.103.5

package/node_modules/properties-file/README.md

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

package/node_modules/properties-file/dist/cjs/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/node_modules/properties-file/dist/cjs/bundler/bun.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"default",{enumerable:!0,get:function(){return _default}});var _nodefs=require("node:fs"),_index=require("../index.js"),bunPlugin={name:"properties-file",setup:function(e){e.onLoad({filter:/\.properties$/},function(e){var r=e.path;return{exports:{properties:(0,_index.getProperties)((0,_nodefs.readFileSync)(r,"utf8"))},loader:"object"}})}},_default=bunPlugin;

package/node_modules/properties-file/dist/cjs/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/node_modules/properties-file/dist/cjs/bundler/esbuild.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"default",{enumerable:!0,get:function(){return _default}});var _nodefs=require("node:fs"),_index=require("../index.js"),esbuildPlugin=function(){return{name:"properties-file",setup:function(e){e.onLoad({filter:/\.properties$/},function(e){var t=e.path;return{contents:"export const properties = ".concat(JSON.stringify((0,_index.getProperties)((0,_nodefs.readFileSync)(t,"utf8"))),";"),loader:"js"}})}}},_default=esbuildPlugin;

package/node_modules/properties-file/dist/cjs/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/node_modules/properties-file/dist/cjs/bundler/rollup.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"default",{enumerable:!0,get:function(){return _default}});var _index=require("../index.js"),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((0,_index.getProperties)(e)),";"),map:null}}}},_default=rollupPlugin;

package/node_modules/properties-file/dist/cjs/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/node_modules/properties-file/dist/cjs/bundler/webpack.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"default",{enumerable:!0,get:function(){return _default}});var _index=require("../index.js"),webpackLoader=function(e){return"exports.properties = ".concat(JSON.stringify((0,_index.getProperties)(e)),";")},_default=webpackLoader;

package/node_modules/properties-file/dist/cjs/characters.d.ts

@@ -0,0 +1,32 @@
+/** Tab character code. */
+export declare const CH_TAB = 9;
+/** Line feed character code. */
+export declare const CH_LF = 10;
+/** Form feed character code. */
+export declare const CH_FF = 12;
+/** Carriage return character code. */
+export declare const CH_CR = 13;
+/** Space character code. */
+export declare const CH_SPACE = 32;
+/** Exclamation mark character code (comment delimiter). */
+export declare const CH_BANG = 33;
+/** Hash character code (comment delimiter). */
+export declare const CH_HASH = 35;
+/** Colon character code (separator). */
+export declare const CH_COLON = 58;
+/** Equals character code (separator). */
+export declare const CH_EQUALS = 61;
+/** Backslash character code (escape / continuation). */
+export declare const CH_BACKSLASH = 92;
+/** Lowercase 'f' character code (formfeed escape). */
+export declare const CH_LOWER_F = 102;
+/** Lowercase 'n' character code (newline escape). */
+export declare const CH_LOWER_N = 110;
+/** Lowercase 'r' character code (carriage return escape). */
+export declare const CH_LOWER_R = 114;
+/** Lowercase 't' character code (tab escape). */
+export declare const CH_LOWER_T = 116;
+/** Lowercase 'u' character code (unicode escape). */
+export declare const CH_LOWER_U = 117;
+/** Byte Order Mark character code. */
+export declare const CH_BOM = 65279;

package/node_modules/properties-file/dist/cjs/characters.js

@@ -0,0 +1 @@
+"use strict";function _export(_,C){for(var e in C)Object.defineProperty(_,e,{enumerable:!0,get:Object.getOwnPropertyDescriptor(C,e).get})}Object.defineProperty(exports,"__esModule",{value:!0}),_export(exports,{get CH_BACKSLASH(){return CH_BACKSLASH},get CH_BANG(){return CH_BANG},get CH_BOM(){return CH_BOM},get CH_COLON(){return CH_COLON},get CH_CR(){return CH_CR},get CH_EQUALS(){return CH_EQUALS},get CH_FF(){return CH_FF},get CH_HASH(){return CH_HASH},get CH_LF(){return CH_LF},get CH_LOWER_F(){return CH_LOWER_F},get CH_LOWER_N(){return CH_LOWER_N},get CH_LOWER_R(){return CH_LOWER_R},get CH_LOWER_T(){return CH_LOWER_T},get CH_LOWER_U(){return CH_LOWER_U},get CH_SPACE(){return CH_SPACE},get CH_TAB(){return CH_TAB}});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;

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"PropertiesEditor",{enumerable:!0,get:function(){return PropertiesEditor}});var _index=require("../escape/index.js"),_properties=require("../parser/properties.js");function _instanceof(e,r){return null!=r&&"undefined"!=typeof Symbol&&r[Symbol.hasInstance]?!!r[Symbol.hasInstance](e):e instanceof r}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(!_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}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}}var DEFAULT_SEPARATOR="=",DEFAULT_COMMENT_DELIMITER="#",REGEX_NEWLINE=/\r\n|\r|\n/,buildPropertyNode=function(e,r,t,n){var o,i=!0===t.escapeUnicode,a=(0,_index.escapeKey)(e,i),s=(0,_index.escapeValue)(r,i),l=" "===t.separator?void 0:null!==(o=t.separator)&&void 0!==o?o:DEFAULT_SEPARATOR,c=l?" ":"",u=l?"".concat(" ").concat(l).concat(c):" ",p="".concat(a).concat(u).concat(s).split(REGEX_NEWLINE);return{type:"property",rawLines:p,leadingWhitespace:"",key:e,escapedKey:a,separatorLeading:" ",separatorChar:l,separatorTrailing:c,value:r,escapedValue:s,startingLineNumber:n,endingLineNumber:n+p.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++)}},PropertiesEditor=function(){function e(){return _class_call_check(this,e),_call_super(this,e,arguments)}return _inherits(e,_properties.Properties),_create_class(e,[{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,i=[];if(void 0!==(null==t?void 0:t.comment)){var a,s=null!==(o=t.commentDelimiter)&&void 0!==o?o:DEFAULT_COMMENT_DELIMITER;(a=i).push.apply(a,_to_consumable_array(buildCommentNodes(t.comment,s,0)))}if(i.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,u="before"===t.position?l.index:l.index+1;return(c=this.nodes).splice.apply(c,[u,0].concat(_to_consumable_array(i))),void recalculateLineNumbers(this.nodes)}}(n=this.nodes).push.apply(n,_to_consumable_array(i)),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,i=buildCommentNodes(e,o,0);if(null==r?void 0:r.referenceKey){var a=this.findLastProperty(r.referenceKey);if(void 0!==a){var s,l="before"===r.position?a.index:a.index+1;return(s=this.nodes).splice.apply(s,[l,0].concat(_to_consumable_array(i))),void recalculateLineNumbers(this.nodes)}}(t=this.nodes).push.apply(t,_to_consumable_array(i)),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,i=this.findLastProperty(e);if(void 0===i)return!1;var a=i.index,s=i.node,l=null!==(t=r.newKey)&&void 0!==t?t:s.key,c=null!==(n=r.newValue)&&void 0!==n?n:s.value,u=!0===r.escapeUnicode,p=u?(0,_index.escapeKey)(l,!0):void 0!==r.newKey?(0,_index.escapeKey)(l):s.escapedKey,d=u?(0,_index.escapeValue)(c,!0):void 0!==r.newValue?(0,_index.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(p).concat(m).concat(d).split(REGEX_NEWLINE),h={type:"property",rawLines:v,leadingWhitespace:s.leadingWhitespace,key:l,escapedKey:p,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=a,g=a-1;g>=0&&"property"!==this.nodes[g].type;g--)L=g;var E=null!==(o=r.commentDelimiter)&&void 0!==o?o:DEFAULT_COMMENT_DELIMITER,N=buildCommentNodes(r.newComment,E,0);(b=this.nodes).splice.apply(b,[L,a-L+1].concat(_to_consumable_array(N),[h]))}else this.nodes[a]=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 i=n,a=n-1;a>=0&&"property"!==this.nodes[a].type;a--)i=a;this.nodes.splice(i,n-i+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()}}]),e}();

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

@@ -0,0 +1 @@
+"use strict";function _export(e,t){for(var r in t)Object.defineProperty(e,r,{enumerable:!0,get:Object.getOwnPropertyDescriptor(t,r).get})}Object.defineProperty(exports,"__esModule",{value:!0}),_export(exports,{get escapeKey(){return escapeKey},get escapeValue(){return escapeValue}});var escapeKey=function(e){return escapeContent(e,!0,arguments.length>1&&void 0!==arguments[1]&&arguments[1])},escapeValue=function(e){return escapeContent(e,!1,arguments.length>1&&void 0!==arguments[1]&&arguments[1])},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/cjs/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/cjs/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"getProperties",{enumerable:!0,get:function(){return q}});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="",t=0,c=0;c<r;)if(92===e.charCodeAt(c)){if(c>t&&(a+=e.slice(t,c)),++c>=r){a+="\\",t=c;break}switch(e.charCodeAt(c)){case 110:a+="\n",c++;break;case 116:a+="\t",c++;break;case 114:a+="\r",c++;break;case 102:a+="\f",c++;break;case 117:if(c+4>=r)throw new Error("malformed escaped unicode characters '".concat(e.slice(c-1,c+5),"'"));var o=_(e.charCodeAt(c+1)),i=_(e.charCodeAt(c+2)),n=_(e.charCodeAt(c+3)),f=_(e.charCodeAt(c+4));if(o<0||i<0||n<0||f<0)throw new Error("malformed escaped unicode characters '".concat(e.slice(c-1,c+5),"'"));a+=String.fromCharCode(o<<12|i<<8|n<<4|f),c+=5;break;default:a+=e.charAt(c),c++}t=c}else c++;return t<r&&(a+=e.slice(t,r)),a},H=function(e,r,a){for(;r<a;){var t=e.charCodeAt(r);if(32!==t&&9!==t&&12!==t)break;r++}return r},q=function(e){for(var r="string"==typeof e?e:e.toString(),a={},t=(r.length>0&&65279===r.charCodeAt(0)?r.slice(1):r).split(/\r\n|\r|\n/),c=t.length,o=0;o<c;){var i=t[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,l=n-1;l>=0&&92===i.charCodeAt(l);l--)d++;var h=d%2==1,v=void 0,u=void 0;if(h){var C=(f>0?i.slice(f):i).slice(0,-1),A=[C];for(u=-1!==C.indexOf("\\");h&&o+1<c;){var b=t[++o],g=b.length,p=H(b,0,g);d=0;for(var k=g-1;k>=p&&92===b.charCodeAt(k);k--)d++;var _=(h=d%2==1)?b.slice(p,g-1):b.slice(p);!u&&-1!==_.indexOf("\\")&&(u=!0),A.push(_)}v=A.join("")}else u=-1!==(v=f>0?i.slice(f):i).indexOf("\\");for(var m=v.length,x=0,O=!1;x<m;){var w=v.charCodeAt(x);if(92!==w){if(!O&&(61===w||58===w||32===w||9===w||12===w))break;O=!1,x++}else O=!O,x++}var j=x;if(j<m){var y=v.charCodeAt(j);(32===y||9===y||12===y)&&((j=H(v,j,m))<m&&(y=v.charCodeAt(j))),j<m&&(61===y||58===y)&&(j++,j=H(v,j,m))}var P=v.slice(0,x),q=v.slice(j);a[u?S(P):P]=u?S(q):q,o++}else o++}}return a};

package/node_modules/properties-file/dist/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

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

@@ -0,0 +1 @@
+"use strict";function _export(e,r){for(var t in r)Object.defineProperty(e,t,{enumerable:!0,get:Object.getOwnPropertyDescriptor(r,t).get})}Object.defineProperty(exports,"__esModule",{value:!0}),_export(exports,{get Properties(){return _properties.Properties},get PropertiesNodeType(){return _nodes.PropertiesNodeType}});var _properties=require("./properties.js"),_nodes=require("./nodes.js");