/**
 * Object utilities. Use this module by importing from `@sirpepe/shed/object`.
 */
import type { QueryPath } from "./types";
/**
 * Returns an unusable object that throws when accessed in any way.
 */
export declare function trap<T extends object = any>(message: string | ((trap: keyof ProxyHandler<any>) => string), ErrorConstructor?: new (reason?: string, cause?: Error) => Error): T;
/**
 * Returns a new object created from the input object, but without the keys in
 * `toOmit`. Essentially the runtime-variant of TypeScript's `Omit<T, K>` type
 * and the inverse of `picked()`.
 */
export declare function omitted<T extends Record<string, unknown>, K extends keyof T>(obj: T, ...toOmit: K[]): Omit<T, K>;
/**
 * Returns a function that returns a new object created from its input object,
 * but without the keys in `toOmit`. Essentially a factory function for
 * functions that call `omitted()`.
 */
export declare function omitter<T extends Record<string, unknown>, K extends keyof T>(...toOmit: K[]): (obj: T) => Omit<T, K>;
/**
 * Returns a new object created from the input object, but with only the keys in
 * `toKeep`. Essentially the runtime-variant of TypeScript's `Pick<T, K>` type
 * and the inverse of `omitted()`.
 */
export declare function picked<T extends Record<string, unknown>, K extends keyof T>(obj: T, ...toKeep: K[]): Pick<T, K>;
/**
 * Returns a function that returns a new object created from its input object,
 * but with only the keys in `toKeep`. Essentially a factory function for
 * functions that call `picked()`.
 */
export declare function picker<T extends Record<string, unknown>, K extends keyof T>(...toKeep: K[]): (obj: T) => Pick<T, K>;
/**
 * Returns a predicate that checks if its input object's "prop" field contains a
 * value equal to "value".
 */
export declare function where<T, K extends keyof T>(prop: K, value: T[K]): (obj: T) => boolean;
/**
 * Returns a predicate that checks if its input object's "prop" field contains a
 * value not equal to "value".
 */
export declare function whereNot<T, K extends keyof T>(prop: K, value: T[K]): (obj: T) => boolean;
/**
 * Returns a getter function that returns every object's "prop" value.
 */
export declare function select<T, K extends keyof T>(prop: K): (obj: T) => T[K];
export declare function hasPath<T extends object>(obj: T, path: "."): true;
export declare function hasPath(obj: object, path: string): boolean;
export declare function getPath<T extends object>(obj: T, path: "."): T;
export declare function getPath<T extends object, P extends string>(obj: T, path: P): QueryPath<T, P>;
export declare function setPath<T extends object>(obj: T, path: ".", value: T): void;
export declare function setPath<T extends object, P extends string>(obj: T, path: P, val: QueryPath<T, P>): void;