/**
 * Peels a candidate string from the start of a string and splits it into two segments.
 *
 * @param str -
 *        The string to peel from.
 * @param candidates -
 *        The candidate list of values to peel from str.
 *
 * @returns
 *        A tuple where the first item is the peeled string and
 *        the second item is the remainder of the string.  If the string
 *        does not start with any given candidates, then the first
 *        item will be null and the second item will be str.
 */
export declare function peel<T extends string = string>(str: string, candidates: T[]): [T | null, string];
/**
 * Peels the values between an opening string set and a closing string set.
 *
 * The actual value will handle issues with internal opening and closing brackets
 *
 * @example
 *
 * ```ts
 * const [peeled, rest] = peelBetween('[a, b, [c1, c2],[d]] other', '[' ']');
 *
 * // Outputs 'a, b, [c1, c2], [d]'
 * console.log(peeled);
 *
 * // Outputs ' other' - white space is included'
 * console.log(rest);
 * ```
 *
 * @param str -
 *        The string to peel between.
 * @param open -
 *        The opening string.  This will test
 *        at the start of str.
 * @param close -
 *        The closing string.  This can be anywhere
 *        in the str.  If this is equal to open, then
 *        the open string is removed from the start of the
 *        string and the rest of the string would be returned.
 *
 * @returns
 *        A tuple where the first argument is string that was found between
 *        the opening and closing bracket. Returns null if no string could
 *        be found between an open and close pair.  The second argument will
 *        be the remaining text of the string, including whitespace.
 */
export declare function peelBetween(str: string, open: string, close: string): [string | null, string];