/**
 * Package-guide plumbing shared by the two distributors that embed or bundle
 * the canonical, tarball-shipped package guides (e.g. `packages/auth/docs/AUTH.md`):
 * `LlmsFullAssembler` (inlines a guide into `llms-full.txt` via a
 * `{{GUIDE:<slug>}}` placeholder) and `ContentBundleEmitter` (emits each guide
 * as `guides/<slug>.md` + an index into the `@urbicon-ui/design-content` bundle).
 * One source, all channels generated — see docs/DOCS-SURFACES.md.
 */
/**
 * A canonical package guide document distributed into the generated channels.
 * The source of truth stays in the package (shipped in its npm tarball);
 * everything here is distribution metadata.
 */
export interface PackageGuide {
    /** Stable bundle id: `guides/<slug>.md`, `{{GUIDE:<slug>}}`, `urbicon guide <slug>`. */
    slug: string;
    /** Human title for guide listings (CLI, MCP resource names). */
    title: string;
    /** One-line description for guide listings. */
    description: string;
    /** Absolute path to the canonical markdown source. */
    sourcePath: string;
}
/** The template placeholder that embeds a guide: `{{GUIDE:<slug>}}`. */
export declare function guidePlaceholder(slug: string): string;
/** Matches any guide placeholder — the fail-loud sweep for unconfigured leftovers. */
export declare const GUIDE_PLACEHOLDER_PATTERN: RegExp;
/**
 * Validate a guide's slug (it becomes a bundle file name and a CLI argument).
 * Throws on anything outside the lowercase-hyphen shape — a bad slug is a
 * build error, never a silently odd bundle path.
 */
export declare function assertGuideSlug(slug: string): void;
/**
 * Demote every ATX heading by `by` levels (capped at h6), leaving fenced code
 * blocks untouched — a guide's own `#`/`##` hierarchy has to nest under the
 * embedding document's section heading without colliding with its h1/h2 levels.
 */
export declare function demoteHeadings(markdown: string, by: number): string;
/**
 * Drop a leading h1 title line (and the blank line after it). The embedding
 * document supplies its own section heading, so the guide's document title
 * would only duplicate it.
 */
export declare function stripLeadingH1(markdown: string): string;
/**
 * The embeddable form of a guide: document title dropped, remaining headings
 * demoted one level (`##` → `###`), so the guide slots under a `##` section
 * of the embedding document.
 */
export declare function renderGuideForEmbedding(markdown: string): string;
//# sourceMappingURL=guide-injection.d.ts.map