import{type AutoloadableTagName}from'./internal/autoloader-tags.js';import{type RenderedTreeTraversalLimit,type RenderedTreeTraversalOptions}from'./internal/rendered-tree-traversal.js';import type{LyraDefinitionRoot}from'./utilities/defined.js';export type{AutoloadableTagName}from'./internal/autoloader-tags.js';export type{LyraDefinitionRoot}from'./utilities/defined.js';export declare const AUTOLOADER_PENDING_ATTRIBUTE="data-lr-autoload-pending";
/**
* Optional-peer components stay excluded unless every package they require is named, or the
* caller deliberately opts into all of them.
*/
export type AutoloaderOptionalPeers='all'|readonly string[]|ReadonlySet<string>;export interface AutoloaderOptions extends RenderedTreeTraversalOptions{
/** Explicit package allowlist for optional-peer components, or `'all'` after installing them. */
readonly optionalPeers?:AutoloaderOptionalPeers;
/** Emit load and traversal lifecycle events on the caller root. */
readonly events?:boolean;
/** Maximum concurrent definition and first-update tasks. Default 16. */
readonly maxConcurrency?:number;}export interface AutoloaderEventDetail{readonly tag:AutoloadableTagName;readonly optionalPeers:readonly string[];}export interface AutoloaderErrorEventDetail extends AutoloaderEventDetail{readonly error:unknown;}export interface AutoloaderTraversalErrorEventDetail{readonly limit:RenderedTreeTraversalLimit;readonly maximum:number;readonly error:Error;}export interface AutoloaderEventMap{'lr-autoload-preload':CustomEvent<AutoloaderEventDetail>;'lr-autoload-loaded':CustomEvent<AutoloaderEventDetail>;'lr-autoload-error':CustomEvent<AutoloaderErrorEventDetail>;'lr-autoload-traversal-error':CustomEvent<AutoloaderTraversalErrorEventDetail>;}
/** Loads and defines the known Lyra tags currently rendered below `root`. */
export declare function discover(root?:LyraDefinitionRoot|undefined,options?:AutoloaderOptions):Promise<readonly AutoloadableTagName[]>;
/**
* Discovers the existing tree and watches additions below the caller-provided document or open
* root. Calling `start()` again first stops the previous observer and invalidates its pending work.
*/
export declare function start(root?:LyraDefinitionRoot|undefined,options?:AutoloaderOptions):Promise<readonly AutoloadableTagName[]>;
/** Disconnects every active observer, invalidates pending work, and removes loader-owned markers. */
export declare function stop():void;