/**
 * Shared entity → snippet planning. Both the Vite plugin (URL generation)
 * and the CLI app-gen (pre-computed rollup inputs) derive snippet slugs
 * from this module, so build inputs always byte-match plugin output.
 */
import type { SdocEntity } from '../language/index.js';
import type { ComponentStatus, DocNote, TodoItem } from '../types.js';
import { exampleSlug, previewSlug } from '../language/parser.js';
export type SnippetRole = 'preview' | 'example' | 'content' | 'prose';
export interface PlannedSnippet {
    name: string;
    slug: string;
    role: SnippetRole;
    /** Full body — block script/style included (display/formatting form) */
    body: string;
    /** Markup between the block script and style (the runtime fragment) */
    markup: string;
    /** Block-level <script> content, when the block declares one */
    script: string | null;
    /** Block-level <style> content, when the block declares one */
    style: string | null;
    /** Short text rendered with the block, when present */
    description: string | null;
    /** An example's tags="…" — what it shows. Absent on other roles. */
    tags?: string[];
    /** An example's [NOTES]. Absent on other roles. */
    notes?: DocNote[];
    /** An example's [TODO] checklist. Absent on other roles. */
    todos?: TodoItem[];
    /** An example's [PROSE], as markdown. Absent on other roles. */
    prose?: string | null;
    /** False when the example says `code="false"`. Absent on other roles. */
    showCode?: boolean;
    /** A preview's synonyms="…" — the component's other names. Absent on
     * other roles. */
    synonyms?: string[];
    /** A preview's status="…" — where the component sits in its life. Absent
     * on other roles, and when the author did not say. */
    status?: ComponentStatus | null;
    /** For a [component] preview: the component reference it demonstrates */
    componentName?: string | null;
}
export { exampleSlug, previewSlug };
/** The snippets one entity produces, in order: prose then previews then
 * examples for SHOWCASE, the 'content' body then examples for DOC, the single
 * 'content' body for PAGE and LAYOUT. DOC and PAGE content and SHOWCASE prose
 * render natively in the Explorer — never served as an iframe page (see
 * planIframeSnippets). */
export declare function planEntitySnippets(entity: SdocEntity): PlannedSnippet[];
/** The snippets of an entity that are served as iframe preview pages:
 * everything except DOC and PAGE content and [PROSE], which render natively
 * in the docs context (a DOC's body also references the Explorer-provided
 * `__sdocsExample` snippet and only compiles there). */
export declare function planIframeSnippets(entity: SdocEntity): PlannedSnippet[];
/** Extract import statements from the file-level script content. Matches on
 * the scrubbed text (comments and string/template contents blanked) so an
 * import-shaped line inside a code sample never counts, then reads the real
 * statement back from the original at the same offsets. */
export declare function extractImports(scriptContent: string): string[];
/** Resolve a `component={…}` reference to an absolute `.svelte` path via the
 * file's imports. Handles a bare identifier (`Button`), a compound default
 * exported from an index module (`NavTree` → index.ts → the root component),
 * and member access into that module (`NavTree.Group` → Group.svelte).
 * Returns null when it can't be traced to a component. */
export declare function resolveComponentImport(componentName: string, imports: string[], docFilePath: string): string | null;