/** Folders whose name starts with '_' hold sequences that only make sense when
 *  another sequence calls them by name — preamble guards, forEach bodies. They
 *  are always LOADED (so those name references resolve) but never run on their
 *  own, where they would fail on unbound variables or an unmet precondition. */
export declare const HELPER_FOLDER_PREFIX = "_";
/**
 * Every .json file under `dir`, recursively, as paths relative to `dir`, sorted.
 * Returns [] when the directory does not exist — an absent sequences dir is a
 * normal state, not an error.
 */
export declare function walkSequenceFiles(dir: string): Promise<string[]>;
/** True when any folder segment of a relative path is a helper folder. */
export declare function isHelperPath(filename: string): boolean;
/**
 * Which sequences a `runAll` should execute.
 *
 * With a folder: everything beneath it (helper folders nested inside are still
 * skipped — asking for spine/ should not run spine/_helpers/). Without one:
 * every sequence except those in helper folders.
 *
 * Selection is deliberately separate from loading: the caller loads the whole
 * tree first so cross-folder name references resolve, then runs only this.
 */
export declare function selectSuiteFiles(filenames: string[], folder?: string): string[];
/** Distinct folder paths present in a set of relative filenames. */
export declare function sequenceFolders(filenames: string[]): string[];
//# sourceMappingURL=sequence-tree.d.ts.map