import { LoadHtmlOptions, RagLoaderResult } from "./loader.type.mjs";

//#region ../ai/src/rag/loaders/load-html.d.ts
/**
 * Load an HTML string into a single {@link RagDocument} of readable text.
 * Scripts, styles, and other non-prose elements are dropped content-and-all,
 * block tags become line breaks (so paragraph structure survives for the
 * splitter), remaining tags are stripped, and HTML entities are decoded — a
 * lightweight regex pass, no heavy DOM dependency.
 *
 * The document's `metadata.title` is set from the page's `<title>` (unless
 * the caller overrode it), and `metadata.loader` is `"html"`. The output is
 * the exact shape `index()` consumes.
 *
 * @example
 * const kb = ai.rag({ embedder, store });
 * await kb.index(loadHtml(rawHtmlString, { id: "landing-page" }));
 *
 * @param html - The raw HTML markup.
 * @param options - Shared `id` / `metadata` / `tags` ({@link LoadHtmlOptions}).
 * @returns A {@link RagLoaderResult} (one document) ready for `rag.index()`.
 */
declare function loadHtml(html: string, options?: LoadHtmlOptions): RagLoaderResult;
//#endregion
export { loadHtml };
//# sourceMappingURL=load-html.d.mts.map