import type { DtifFlattenedToken, RuleModule } from '../core/types.js';
import type { KernelConfig } from '../config/kernel-config.js';
import type { ComponentInput } from '@lapidist/dscp';
type DocsFormat = 'vitepress' | 'markdown';
interface DocsCommandOptions {
    /** Output directory. Defaults to `./docs/design-system`. */
    out?: string;
    /** Output format. Defaults to `vitepress`. */
    format?: DocsFormat;
    /** Optional path to a configuration file. */
    config?: string;
}
export type LoadConfigFn = (cwd: string, configPath?: string) => Promise<KernelConfig>;
export declare function tokenValueToString(value: unknown): string;
export declare function groupTokensByType(tokens: DtifFlattenedToken[]): Map<string, DtifFlattenedToken[]>;
export declare function generateTokenTypePage(typeName: string, tokens: DtifFlattenedToken[]): string;
export declare function generateRulePage(rule: RuleModule): string;
export declare function generateComponentsPage(components: ComponentInput[]): string;
export declare function generateIndexPage(tokenTypes: string[], ruleNames: string[], hasComponents?: boolean): string;
export declare function generateVitePressConfig(tokenTypes: string[], ruleNames: string[]): string;
/**
 * Generate a static documentation site from design-lint kernel state.
 *
 * @param options - Command options controlling output directory and format.
 * @param loadConfigFn - Optional override for config loading (used in tests).
 */
export declare function generateDocs(options: DocsCommandOptions, loadConfigFn?: LoadConfigFn): Promise<void>;
export {};
//# sourceMappingURL=docs.d.ts.map