/**
 * Index used for a rendered repeating group instance that has no counterpart in the
 * QuestionnaireResponse — an instance the user added but never filled in, or an unselected gtable row.
 *
 * Validation only ever walks instances that exist in the QuestionnaireResponse, so its indices are
 * always >= 0. Using a negative index therefore produces a key that validation can never write,
 * which is exactly what we want: such an instance can't be invalid, so it must not match anything.
 *
 * @author Clinton Gillespie
 */
export declare const UNMATCHABLE_REPEAT_INSTANCE_INDEX = -1;
/**
 * Appends a repeating group instance to the enclosing instance-index path.
 *
 * `qrInstanceIndex` must be the instance's index within the **QuestionnaireResponse**, not its index
 * in the rendered list — the two differ whenever an earlier instance is absent from the QR (see
 * {@link getQrRepeatGroupInstanceIndexes} and {@link getQrGroupTableRowIndexes}). Pass `null` when the
 * instance has no QR counterpart at all.
 *
 * @author Clinton Gillespie
 */
export declare function appendRepeatInstanceIndex(parentRepeatInstancePath: number[], qrInstanceIndex: number | null): number[];
/**
 * Builds the key used to store/look up a validation OperationOutcome in `invalidItems`.
 *
 * For non-repeating items (empty path) the key is simply the `linkId`, so behaviour is unchanged.
 * For items inside one or more repeating group instances, the key is suffixed with the path of
 * enclosing instance indices (e.g. `myField///1` or `myField///0.2` when nested). This lets each
 * repeat instance track its own validation errors instead of all instances sharing a single key.
 *
 * Indices are positions within the QuestionnaireResponse, since that is what validation walks.
 *
 * @author Clinton Gillespie
 */
export declare function getValidationErrorKey(linkId: string, repeatInstancePath?: number[]): string;
/**
 * Recovers the base `linkId` from an instance-scoped validation error key produced by
 * {@link getValidationErrorKey}. Useful for consumers that need to map error keys back to
 * Questionnaire items (e.g. finding which tab contains the first error).
 *
 * Note this truncates at the first separator, so a linkId that itself contains `///` would be
 * shortened. Such linkIds are not expected in practice.
 *
 * @author Clinton Gillespie
 */
export declare function getBaseLinkIdFromErrorKey(errorKey: string): string;