/**
 * Returns a new object with a single key renamed, preserving all other keys
 * and values unchanged. The key order in the result follows the original
 * object's insertion order, with the renamed key at its original position.
 *
 * @template T - The type of the object values.
 * @param obj - The source object.
 * @param oldKey - The key to rename.
 * @param newKey - The new name for the key.
 * @returns A new object with the key renamed.
 *
 * @throws {Error} If oldKey does not exist on the object.
 * @throws {Error} If newKey already exists on the object (prevents silent overwrite).
 *
 * @example
 * // Basic rename
 * renameKey({ id: 1, name: 'Alice' }, 'id', 'userId');
 * // { userId: 1, name: 'Alice' }
 *
 * @example
 * // Rename preserves insertion order
 * renameKey({ a: 1, b: 2, c: 3 }, 'b', 'beta');
 * // { a: 1, beta: 2, c: 3 }
 *
 * @example
 * // Useful for normalising API response field names
 * renameKey(apiResponse, 'user_id', 'userId');
 *
 * @note The original object is not mutated; a shallow copy is returned.
 * @note To rename multiple keys, use transformKeys with a mapping function.
 *
 * @complexity Time: O(n), Space: O(n) where n is the number of keys
 */
export declare function renameKey<T>(obj: Record<string, T>, oldKey: string, newKey: string): Record<string, T>;
//# sourceMappingURL=renameKey.d.ts.map