obsidian-dev-utils 19.1.2-beta.2 → 19.1.2-beta.3

package/dist/lib/esm/CssClass.d.mts

@@ -1 +1,97 @@
-export * from '../cjs/CssClass.cjs';
+/**
+ * @packageDocumentation CssClass
+ * CSS classes used by the `obsidian-dev-utils` library.
+ */
+/**
+ * CSS classes used by the `obsidian-dev-utils` library.
+ */
+export declare enum CssClass {
+    /**
+     * The CSS class for the alert modal.
+     */
+    AlertModal = "alert-modal",
+    /**
+     * The CSS class for the cancel button.
+     */
+    CancelButton = "cancel-button",
+    /**
+     * The CSS class for the confirm modal.
+     */
+    ConfirmModal = "confirm-modal",
+    /**
+     * The CSS class for the date component.
+     */
+    DateComponent = "date-component",
+    /**
+     * The CSS class for the date and time component.
+     */
+    DateTimeComponent = "datetime-component",
+    /**
+     * The CSS class for the email component.
+     */
+    EmailComponent = "email-component",
+    /**
+     * The CSS class for the file component.
+     */
+    FileComponent = "file-component",
+    /**
+     * The CSS class for the library name.
+     */
+    LibraryName = "obsidian-dev-utils",
+    /**
+     * The CSS class for the month component.
+     */
+    MonthComponent = "month-component",
+    /**
+     * The CSS class for the multiple dropdown component.
+     */
+    MultipleDropdownComponent = "multiple-dropdown-component",
+    /**
+     * The CSS class for the multiple email component.
+     */
+    MultipleEmailComponent = "multiple-email-component",
+    /**
+     * The CSS class for the multiple file component.
+     */
+    MultipleFileComponent = "multiple-file-component",
+    /**
+     * The CSS class for the multiple text component.
+     */
+    MultipleTextComponent = "multiple-text-component",
+    /**
+     * The CSS class for the number component.
+     */
+    NumberComponent = "number-component",
+    /**
+     * The CSS class for the ok button.
+     */
+    OkButton = "ok-button",
+    /**
+     * The CSS class for the plugin settings tab.
+     */
+    PluginSettingsTab = "plugin-settings-tab",
+    /**
+     * The CSS class for the prompt modal.
+     */
+    PromptModal = "prompt-modal",
+    /**
+     * The CSS class for the select item modal.
+     */
+    SelectItemModal = "select-item-modal",
+    /**
+     * The CSS class for the text box.
+     */
+    TextBox = "text-box",
+    /**
+     * The CSS class for the time component.
+     */
+    TimeComponent = "time-component",
+    /**
+     * The CSS class for the url component.
+     */
+    UrlComponent = "url-component",
+    /**
+     * The CSS class for the week component.
+     */
+    WeekComponent = "week-component"
+}

package/dist/lib/esm/Debug.d.mts

@@ -1 +1,41 @@
-export * from '../cjs/Debug.cjs';
+/**
+ * @packageDocumentation Debug
+ * Contains utility functions for debugging.
+ */
+import type { Debugger } from 'debug';
+import type { DebugController } from './DebugController.d.mts';
+interface DebuggerEx extends Debugger {
+    printStackTrace(stackTrace: string, title?: string): void;
+}
+/**
+ * Enables the debuggers for the `obsidian-dev-utils` library.
+ */
+export declare function enableLibraryDebuggers(): void;
+/**
+ * Returns a debug controller.
+ *
+ * @returns A debug controller.
+ */
+export declare function getDebugController(): DebugController;
+/**
+ * Returns a debugger instance with a log function that includes the caller's file name and line number.
+ *
+ * @param namespace - The namespace for the debugger instance.
+ * @param framesToSkip - The number of frames to skip in the stack trace.
+ * @returns A debugger instance with a log function that includes the caller's file name and line number.
+ */
+export declare function getDebugger(namespace: string, framesToSkip?: number): DebuggerEx;
+/**
+ * Returns a debugger instance for the `obsidian-dev-utils` library.
+ *
+ * @param namespace - The namespace for the debugger instance.
+ * @returns A debugger instance for the `obsidian-dev-utils` library.
+ */
+export declare function getLibDebugger(namespace: string): DebuggerEx;
+/**
+ * Shows an initial debug message.
+ *
+ * @param pluginId - The plugin ID.
+ */
+export declare function showInitialDebugMessage(pluginId: string): void;
+export {};

package/dist/lib/esm/DebugController.d.mts

@@ -1 +1,85 @@
-export * from '../cjs/DebugController.cjs';
+/**
+ * @packageDocumentation
+ * Provides the interface for controlling debug output through namespace management.
+ *
+ * Debug namespaces follow the pattern 'lorem', `lorem:ipsum`, `lorem:ipsum:dolor`, etc, and can use wildcards (`*`).
+ *
+ * @example
+ * - `lorem:*` matches all submodules of 'lorem'
+ * - `*:ipsum` matches all plugins' `ipsum` submodules
+ * - `*` matches everything
+ *
+ * Special syntax:
+ * - Namespaces prefixed with '-' are explicitly disabled
+ * - Multiple namespaces can be combined with commas: `lorem,-lorem:ipsum,dolor:*`
+ *
+ * @see {@link https://github.com/mnaoumov/obsidian-dev-utils/?tab=readme-ov-file#debugging}
+ */
+/**
+ * Controls debug output by managing debug namespaces.
+ * Exposed globally as `window.DEBUG`.
+ *
+ * @remarks
+ * Debug settings persist across plugin reloads in localStorage.
+ */
+export interface DebugController {
+    /**
+     * Disable specific debug namespaces. Disabled namespaces take precedence
+     * over enabled ones when there's a conflict.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.disable('foo-bar'); // hide all debug messages from the `foo-bar` plugin
+     * window.DEBUG.disable('foo-bar:*'); // hide all debug messages from the `foo-bar` plugin submodules
+     * window.DEBUG.disable(['foo-bar', 'baz-qux']); // disable multiple namespaces
+     * window.DEBUG.disable('foo-bar,baz-qux'); // disable multiple namespaces using comma-separated string
+     * window.DEBUG.disable('*'); // disable all debug messages
+     * ```
+     *
+     * @param namespaces - Single namespace string or array of namespace strings to disable
+     */
+    disable(namespaces: string | string[]): void;
+    /**
+     * Enable specific debug namespaces. Note that explicitly disabled
+     * namespaces (prefixed with '-') will remain disabled.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.enable('foo-bar'); // show all debug messages from the `foo-bar` plugin
+     * window.DEBUG.enable('foo-bar:obsidian-dev-utils:*'); // show all debug messages from the `obsidian-dev-utils` library within the `foo-bar` plugin
+     * window.DEBUG.enable('foo-bar:*'); // show all debug messages from the `foo-bar` plugin and its submodules
+     * window.DEBUG.enable('*:obsidian-dev-utils:*'); // show all debug messages for the `obsidian-dev-utils` library within any plugin
+     * window.DEBUG.enable(['foo-bar', 'baz-qux']); // enable multiple namespaces
+     * window.DEBUG.enable('foo-bar,baz-qux'); // enable multiple namespaces using comma-separated string
+     * window.DEBUG.enable('*'); // show all debug messages
+     * ```
+     *
+     * @param namespaces - Single namespace string or array of namespace strings to enable
+     */
+    enable(namespaces: string | string[]): void;
+    /**
+     * Get currently configured debug namespaces.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.get(); // returns ['foo-bar', 'baz-qux:*', '-lorem-ipsum']
+     * ```
+     *
+     * @returns Array of enabled and disabled (prefixed with `-`) debug namespaces
+     */
+    get(): string[];
+    /**
+     * Set debug namespaces, replacing all previous configurations.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.set(['foo-bar', 'baz-qux:*', '-lorem-ipsum']); // Enable 'foo-bar' and 'baz-qux:*', explicitly disable 'lorem-ipsum'
+     * window.DEBUG.set('foo-bar,baz-qux:*,-lorem-ipsum'); // Same thing using comma-separated string
+     * window.DEBUG.set('*'); // Enable all debug messages
+     * window.DEBUG.set(''); // Disable all debug messages
+     * ```
+     *
+     * @param namespaces - String or array of namespace patterns
+     */
+    set(namespaces: string | string[]): void;
+}

package/dist/lib/esm/Enum.d.mts

@@ -1 +1,20 @@
-export * from '../cjs/Enum.cjs';
+/**
+ * @packageDocumentation Enum
+ * Contains utility functions for enums.
+ */
+/**
+ * Get the key of an enum value.
+ *
+ * @param enumType - The enum type.
+ * @param value - The value to get the key of.
+ * @returns The key of the enum value.
+ */
+export declare function getEnumKey<T extends Record<string, string>>(enumType: T, value: T[keyof T]): keyof T;
+/**
+ * Get the value of an enum key.
+ *
+ * @param enumType - The enum type.
+ * @param key - The key to get the value of.
+ * @returns The value of the enum key.
+ */
+export declare function getEnumValue<T extends Record<string, string>>(enumType: T, key: string): T[keyof T];

package/dist/lib/esm/Error.d.mts

@@ -1 +1,45 @@
-export * from '../cjs/Error.cjs';
+/**
+ * @packageDocumentation Error
+ * Contains utility functions for error handling.
+ */
+/**
+ * Emits an asynchronous error event.
+ *
+ * @param asyncError - The error to emit as an asynchronous error event.
+ */
+export declare function emitAsyncErrorEvent(asyncError: unknown): void;
+/**
+ * Converts an error to a string representation, including nested causes with indentation.
+ *
+ * @param error - The error to convert to a string.
+ * @returns The string representation of the error.
+ */
+export declare function errorToString(error: unknown): string;
+/**
+ * Gets the current stack trace as a string, excluding the current function call.
+ *
+ * @param framesToSkip - The number of frames to skip in the stack trace.
+ * @returns A string representation of the current stack trace, excluding the current function call.
+ */
+export declare function getStackTrace(framesToSkip?: number): string;
+/**
+ * Prints an error to the console, including nested causes and optional ANSI sequence clearing.
+ *
+ * @param error - The error to print.
+ * @param console - The console to print to (default: `globalThis.console`).
+ */
+export declare function printError(error: unknown, console?: Console): void;
+/**
+ * Registers an event handler for asynchronous errors.
+ *
+ * @param handler - The handler function to be called when an asynchronous error event occurs.
+ * @returns A function to unregister the handler.
+ */
+export declare function registerAsyncErrorEventHandler(handler: (asyncError: unknown) => void): () => void;
+/**
+ * Throws an error with the specified message.
+ *
+ * @param error - The error to throw.
+ * @returns A never-returning function.
+ */
+export declare function throwExpression(error: unknown): never;

package/dist/lib/esm/Function.d.mts

@@ -1 +1,28 @@
-export * from '../cjs/Function.cjs';
+/**
+ * @packageDocumentation Function
+ * Contains utility functions for working with functions.
+ */
+/**
+ * A function that does nothing.
+ */
+export declare function noop(): void;
+/**
+ * A function that does nothing.
+ */
+export declare function noopAsync(): Promise<void>;
+/**
+ * Makes an async function that calls the original async function with the provided arguments and omits the return value.
+ *
+ * @typeParam Args - Arguments to be passed to the function.
+ * @param fn - Function to be called.
+ * @returns An async function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitAsyncReturnType<Args extends unknown[]>(fn: (...args: Args) => Promise<unknown>): (...args: Args) => Promise<void>;
+/**
+ * Makes a function that calls the original function with the provided arguments and omits the return value.
+ *
+ * @typeParam Args - Arguments to be passed to the function.
+ * @param fn - Function to be called.
+ * @returns A function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitReturnType<Args extends unknown[]>(fn: (...args: Args) => unknown): (...args: Args) => void;

package/dist/lib/esm/HTMLElement.d.mts

@@ -1 +1,49 @@
-export * from '../cjs/HTMLElement.cjs';
+/**
+ * @packageDocumentation HTMLElement
+ * Helpers for working with HTML elements.
+ */
+/**
+ * A HTML element that can be validated.
+ */
+export interface ValidatorElement extends HTMLElement {
+    /**
+     * Checks the validity of the element.
+     *
+     * @returns True if the element is valid, false otherwise.
+     */
+    checkValidity(): boolean;
+    /**
+     * Reports the validity of the element.
+     */
+    reportValidity(): boolean;
+    /**
+     * Sets a custom error message on the element.
+     * @param error - The error message to set on the element.
+     */
+    setCustomValidity(error: string): void;
+    /**
+     * The error message of the element.
+     */
+    readonly validationMessage: string;
+}
+/**
+ * Appends a code block to the given DocumentFragment or HTMLElement.
+ *
+ * @param el - The DocumentFragment or HTMLElement to append the code block to.
+ * @param code - The code to be displayed in the code block.
+ */
+export declare function appendCodeBlock(el: DocumentFragment | HTMLElement, code: string): void;
+/**
+ * Ensures that the given element is loaded.
+ *
+ * @param el - The element to ensure is loaded.
+ * @returns A promise that resolves when the element is loaded.
+ */
+export declare function ensureLoaded(el: Element): Promise<void>;
+/**
+ * Checks if the element is loaded.
+ *
+ * @param el - The element to check.
+ * @returns True if the element is loaded, false otherwise.
+ */
+export declare function isLoaded(el: Element): boolean;

package/dist/lib/esm/Library.d.mts

@@ -1 +1,16 @@
-export * from '../cjs/Library.cjs';
+/**
+ * @packageDocumentation Library
+ * Helpers for working with the `obsidian-dev-utils` library.
+ */
+/**
+ * The version of the `obsidian-dev-utils` library.
+ */
+export declare const LIBRARY_VERSION = "$(LIBRARY_VERSION)";
+/**
+ * The name of the `obsidian-dev-utils` library.
+ */
+export declare const LIBRARY_NAME = "obsidian-dev-utils";
+/**
+ * The styles of the `obsidian-dev-utils` library.
+ */
+export declare const LIBRARY_STYLES = "$(LIBRARY_STYLES)";

package/dist/lib/esm/Library.mjs

@@ -5,7 +5,7 @@ if you want to view the source, please visit the github repository of this plugi
 
 (function initEsm(){if(globalThis.process){return}const browserProcess={browser:true,cwd:__name(()=>"/","cwd"),env:{},platform:"android"};globalThis.process=browserProcess})();
 
-const LIBRARY_VERSION = "19.1.2-beta.2";
+const LIBRARY_VERSION = "19.1.2-beta.3";
 const LIBRARY_NAME = "obsidian-dev-utils";
 const LIBRARY_STYLES = ".obsidian-dev-utils :invalid {\n  box-shadow: 0 0 0 2px var(--text-error);\n}\n.obsidian-dev-utils.modal-container .ok-button {\n  margin-right: 10px;\n  margin-top: 20px;\n}\n.obsidian-dev-utils .multiple-dropdown-component select,\n.obsidian-dev-utils .multiple-dropdown-component select:focus,\n.obsidian-dev-utils .multiple-dropdown-component .dropdown {\n  height: auto;\n}\n.obsidian-dev-utils .multiple-dropdown-component select option:checked,\n.obsidian-dev-utils .multiple-dropdown-component select:focus option:checked,\n.obsidian-dev-utils .multiple-dropdown-component .dropdown option:checked {\n  background-color: #1967d2;\n  color: #fff;\n}\n.obsidian-dev-utils.prompt-modal .text-box {\n  width: 100%;\n}\n\n/*# sourceMappingURL=data:application/json;charset=utf-8,%7B%22version%22:3,%22sourceRoot%22:%22%22,%22sources%22:%5B%22../src/styles/main.scss%22%5D,%22names%22:%5B%5D,%22mappings%22:%22AACE;EACE;;AAIA;EACE;EACA;;AAKF;AAAA;AAAA;EAGE;;AAEA;AAAA;AAAA;EACE;EACA;;AAMJ;EACE%22,%22file%22:%22styles.css%22,%22sourcesContent%22:%5B%22.obsidian-dev-utils%20%7B%5Cn%20%20:invalid%20%7B%5Cn%20%20%20%20box-shadow:%200%200%200%202px%20var(--text-error);%5Cn%20%20%7D%5Cn%5Cn%20%20&.modal-container%20%7B%5Cn%20%20%20%20.ok-button%20%7B%5Cn%20%20%20%20%20%20margin-right:%2010px;%5Cn%20%20%20%20%20%20margin-top:%2020px;%5Cn%20%20%20%20%7D%5Cn%20%20%7D%5Cn%5Cn%20%20.multiple-dropdown-component%20%7B%5Cn%20%20%20%20select,%5Cn%20%20%20%20select:focus,%5Cn%20%20%20%20.dropdown%20%7B%5Cn%20%20%20%20%20%20height:%20auto;%5Cn%5Cn%20%20%20%20%20%20option:checked%20%7B%5Cn%20%20%20%20%20%20%20%20background-color:%20%231967d2;%5Cn%20%20%20%20%20%20%20%20color:%20%23fff;%5Cn%20%20%20%20%20%20%7D%5Cn%20%20%20%20%7D%5Cn%20%20%7D%5Cn%5Cn%20%20&.prompt-modal%20%7B%5Cn%20%20%20%20.text-box%20%7B%5Cn%20%20%20%20%20%20width:%20100%25;%5Cn%20%20%20%20%7D%5Cn%20%20%7D%5Cn%7D%5Cn%22%5D%7D */\n";
 export {

package/dist/lib/esm/Object.d.mts

@@ -1 +1,211 @@
-export * from '../cjs/Object.cjs';
+/**
+ * @packageDocumentation Object
+ * Contains utility functions for Objects.
+ */
+import type { UndefinedOnPartialDeep } from 'type-fest';
+/**
+ * Specifies how functions should be handled in the JSON output.
+ */
+export declare enum FunctionHandlingMode {
+    /**
+     * Excludes functions from the JSON output.
+     */
+    Exclude = "exclude",
+    /**
+     * Includes the full function definition in the JSON output.
+     */
+    Full = "full",
+    /**
+     * Includes only the function name in the JSON output.
+     */
+    NameOnly = "nameOnly"
+}
+/**
+ * Represents a constructor type for a given class `T` with arguments `Args`.
+ *
+ * @typeParam Type - The type of the instance being constructed.
+ * @typeParam Args - The types of arguments the constructor accepts.
+ */
+export type Constructor<Type, Args extends unknown[] = []> = new (...args: Args) => Type;
+/**
+ * Extracts the keys of a given type `Type` that match a specific value type `Value`.
+ *
+ * @typeParam Type - The type from which to extract the keys.
+ * @typeParam Value - The value type to match against.
+ */
+export type KeysMatching<Type, Value> = {
+    [Key in keyof Type]-?: Type[Key] extends Value ? Key : never;
+}[keyof Type];
+/**
+ * Options for converting an object to JSON.
+ */
+export interface ToJsonOptions {
+    /**
+     * Specifies how functions should be handled in the JSON output (default: `exclude`).
+     */
+    functionHandlingMode: FunctionHandlingMode;
+    /**
+     * Specifies the maximum depth of nested objects to include in the JSON output.
+     * Use `-1` for no limit.
+     * Defaults to `-1`.
+     */
+    maxDepth: number;
+    /**
+     * Specifies whether to catch errors in `toJSON()` and replace them with a placeholder.
+     * Defaults to `false`.
+     */
+    shouldCatchToJSONErrors: boolean;
+    /**
+     * Specifies whether to handle circular references in the JSON output.
+     * Defaults to `false`.
+     */
+    shouldHandleCircularReferences: boolean;
+    /**
+     * Specifies whether to handle errors in the JSON output.
+     * Defaults to `false`.
+     */
+    shouldHandleErrors: boolean;
+    /**
+     * Specifies whether to handle undefined values in the JSON output.
+     * Defaults to `false`.
+     */
+    shouldHandleUndefined: boolean;
+    /**
+     * Specifies whether to sort the keys of the JSON output.
+     * Defaults to `false`.
+     */
+    shouldSortKeys: boolean;
+    /**
+     * Specifies the indentation of the JSON output. This can be a number of spaces or a string. Defaults to `2`.
+     */
+    space: number | string;
+    /**
+     * Specifies the substitutions to use in the JSON output.
+     */
+    tokenSubstitutions: Partial<TokenSubstitutions>;
+}
+interface TokenSubstitutions {
+    circularReference: string;
+    maxDepthLimitReached: string;
+    toJSONFailed: string;
+}
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @param target - The target object to assign properties to.
+ * @param source - The source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U>(target: T, source: U): T & U;
+/**
+ * @param target - The target object to assign properties to.
+ * @param source1 - The first source object to assign properties from.
+ * @param source2 - The second source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U, V>(target: T, source1: U, source2: V): T & U & V;
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @param target - The target object to assign properties to.
+ * @param source1 - The first source object to assign properties from.
+ * @param source2 - The second source object to assign properties from.
+ * @param source3 - The third source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+/**
+ * Clones an object, including non-enumerable properties.
+ *
+ * @param obj - The object to clone.
+ * @returns A new object with the same properties as the original object, including non-enumerable properties.
+ */
+export declare function cloneWithNonEnumerableProperties<T extends object>(obj: T): T;
+/**
+ * Compares two values to determine if they are deeply equal.
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns `true` if the values are deeply equal, otherwise `false`.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Deletes multiple properties from an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param obj - The object to delete the properties from.
+ * @param propertyNames - The names of the properties to delete.
+ * @returns `true` if any of the properties were present, otherwise `false`.
+ */
+export declare function deleteProperties<T extends object>(obj: T, propertyNames: (keyof T)[]): boolean;
+/**
+ * Deletes a property from an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param obj - The object to delete the property from.
+ * @param propertyName - The name of the property to delete.
+ * @returns `true` if the property was present, otherwise `false`.
+ */
+export declare function deleteProperty<T extends object>(obj: T, propertyName: keyof T): boolean;
+/**
+ * Gets the value of a nested property from an object.
+ *
+ * @param obj - The object to get the nested property value from.
+ * @param path - The path to the nested property.
+ * @returns The value of the nested property.
+ */
+export declare function getNestedPropertyValue(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Gets the prototype of the specified object.
+ *
+ * @typeParam T - The type of the object.
+ * @param instance - The object instance to retrieve the prototype of.
+ * @returns The prototype of the object.
+ */
+export declare function getPrototypeOf<T>(instance: T): T;
+/**
+ * Retrieves the name of a property of a given type `T`.
+ *
+ * @typeParam T - The type of the object containing the property.
+ * @param name - The name of the property as a string.
+ * @returns The name of the property.
+ */
+export declare function nameof<T>(name: Extract<keyof T, string>): string;
+/**
+ * Normalizes optional properties to allow `undefined` assignment in strict mode.
+ *
+ * This utility provides a workaround for the `exactOptionalPropertyTypes` TypeScript flag,
+ * which prohibits directly assigning `undefined` to optional properties when the type
+ * explicitly omits `undefined`.
+ *
+ * Example:
+ * ```typescript
+ * // With `exactOptionalPropertyTypes: true`
+ * const x: { prop?: string } = { prop: undefined }; // Compiler error
+ *
+ * // Using this utility:
+ * const y: { prop?: string } = normalizeOptionalProperties<{ prop?: string }>({ prop: undefined }); // Works
+ * ```
+ *
+ * @typeParam T - The target type with optional properties to normalize.
+ * @param obj - The object to normalize, allowing explicit `undefined` for optional properties.
+ * @returns The normalized object, compatible with `exactOptionalPropertyTypes`.
+ */
+export declare function normalizeOptionalProperties<T>(obj: UndefinedOnPartialDeep<T>): T;
+/**
+ * Sets the value of a nested property in an object.
+ *
+ * @param obj - The object to set the nested property value in.
+ * @param path - The path to the nested property.
+ * @param value - The value to set.
+ */
+export declare function setNestedPropertyValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Converts a given value to a JSON string.
+ *
+ * @param value - The value to be converted to JSON. This can be of any type.
+ * @param options - Options for customizing the JSON conversion process.
+ * @returns The JSON string representation of the input value.
+ */
+export declare function toJson(value: unknown, options?: Partial<ToJsonOptions>): string;
+export {};