/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 *   Utility functions for working with objects.
 */
import type { PathBuilderLike } from "path-ts";
import type { JsonObject } from "type-fest";
type SetLike<T> = {
    has(value: T): boolean;
} | Iterable<T>;
/**
 * Type-utility for extracting the string keys of an object.
 *
 * @internal
 */
export type StringKeyOf<O> = Extract<keyof O, string>;
/**
 * @param input Source object.
 * @param scalarEnum Unconstrained scalar enum whose values present in `input` will be used as keys, such as an
 *   enum-like object.
 *
 * @returns A subset of the source object with only properties present in `scalarEnum`.
 */
export declare function pick<O extends object, K extends string>(input: O, scalarEnum: Record<K, K>, transform?: (value: O[keyof O], key: keyof O, input: O) => O[keyof O]): Pick<O, StringKeyOf<O>>;
/**
 * @param input Source object.
 * @param setLike Set-like object whose members represent the subset of keys to pick.
 *
 * @returns A subset of the source object with only properties present in `scalarEnum`.
 */
export declare function pick<O extends object, K extends keyof O>(input: O, setLike: SetLike<K>, transform?: (value: O[keyof O], key: keyof O, input: O) => O[keyof O]): Pick<O, K>;
/**
 * @param input Source object.
 * @param scalarEnum Enum-like object whose members represent the subset of keys to pick.
 *
 * @returns A subset of the source object with only properties present in `scalarEnum`.
 */
export declare function pick<O extends object, K extends keyof O>(input: O, scalarEnum: Record<K, K>, transform?: (value: O[keyof O], key: keyof O, input: O) => O[keyof O]): Pick<O, StringKeyOf<O>>;
/**
 * @param input Source object.
 * @param constraints Unconstrained iterable of keys to pick, such as in array or Map.
 *
 * @returns A subset of the source object with only properties present in `constraints`.
 */
export declare function pick<O extends object, K extends keyof O = StringKeyOf<O>>(input: O, constraints: Iterable<K>, transform?: (value: O[keyof O], key: keyof O, input: O) => O[keyof O]): Pick<O, K>;
/**
 * @param input Source object.
 * @param constraints Enum-like object whose members represent the subset of keys to pick.
 *
 * @returns A subset of the source object with only properties present in `constraints`.
 */
export declare function pick<O extends object, K extends keyof O = StringKeyOf<O>>(input: O, constraints: Record<K, K>, transform?: (value: O[keyof O], key: keyof O, input: O) => O[keyof O]): Pick<O, K>;
/**
 * @param input Source object.
 * @param keys Unconstrained iterable of keys to pick, such as in array or Map.
 *
 * @returns A subset of the source object with only properties present in `keys`.
 */
export declare function pick<O extends object, K extends string>(input: O, keys: Iterable<K>, transform?: (value: O[keyof O], key: keyof O, input: O) => O[keyof O]): Pick<O, StringKeyOf<O>>;
/**
 * Type-predicate for checking if a value appears to be a record, i.e. an object that is not an array.
 *
 * @category Type Guard
 * @category Object
 */
export declare function isRecordLike(input: unknown): input is object;
type Falsy = false | 0 | 0n | "" | null | undefined;
/**
 * Typed counterpart to `Boolean` for collection filters. The runtime semantics are intentionally identical: all falsy
 * values are removed, while the overload narrows them out of the resulting element type.
 */
export declare function isPresent<T>(input: T): input is Exclude<T, Falsy>;
/**
 * Type-helper to remove nullability from an object's properties.
 *
 * @category Object
 */
export type NonNullableObject<T> = {
    [P in keyof T]-?: NonNullable<T[P]>;
} & NonNullable<T>;
/**
 * Given an object, returns a new object with all nullable properties removed.
 *
 * This is useful for cleaning up objects before serializing them to JSON.
 *
 * @category Object
 */
export declare function omitNullable<T extends object>(input: T): NonNullableObject<T>;
/**
 * Given serialized JSON, attempt to parse it.
 *
 * Non-throwing: invalid JSON — and any non-string input, `Buffer` included — returns the fallback (`null` unless one is
 * given). Callers that need a throw on corrupt input, or `JSON.parse`'s reviver parameter, use `JSON.parse` directly
 * behind a scoped lint disable.
 */
export declare function tryParsingJSON<T = unknown>(input: unknown): T | null;
export declare function tryParsingJSON<T = unknown, F = T>(input: unknown, fallback: F): T | F;
export declare class JSONParseError extends Error {
    constructor(message: string, options?: ErrorOptions);
}
/**
 * Parses JSON input or throws a `JSONParseError` if parsing fails.
 *
 * @param input - The JSON input to parse.
 *
 * @returns The parsed object.
 */
export declare function parseJSONStrict<T = unknown>(input: PathBuilderLike): T;
export type FlattenObjectKeys<T extends JsonObject, Key = keyof T> = Key extends string ? T[Key] extends JsonObject ? `${Key}.${FlattenObjectKeys<T[Key]>}` : `${Key}` : never;
/**
 * Flattens an object into a single-level object with dot-separated keys.
 */
export declare function flattenObject<T extends JsonObject>(obj: T, prefix?: string[], current?: Record<string, unknown>): Record<FlattenObjectKeys<T>, unknown>;
export {};
//# sourceMappingURL=objects.d.ts.map