/**
 * This file is part of the NocoBase (R) project.
 * Copyright (c) 2020-2024 NocoBase Co., Ltd.
 * Authors: NocoBase Team.
 *
 * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
 * For more information, please refer to: https://www.nocobase.com/agreement.
 */
import type { NamePath } from './types';
export type PathSegment = string | number | {
    placeholder: string;
};
export declare function parsePathString(path: string): PathSegment[];
/**
 * Resolve a dynamic NamePath using the current row index context (`fieldIndex`).
 *
 * - Supports placeholders: `users[placeholder].name`
 * - Auto-fills to-many index when omitted: `users.name` -> `users[ctxIndex].name`
 *
 * Returns `null` when a placeholder can't be resolved in current context.
 */
export declare function resolveDynamicNamePath(path: string | NamePath, fieldIndex?: unknown): NamePath | null;
export declare function namePathToPathKey(namePath: Array<string | number>): string;
export declare function pathKeyToNamePath(pathKey: string): NamePath;
export declare function buildAncestorKeys(namePath: NamePath): string[];
