/**
 * Scan all `.stx` files in the project and determine the build mode.
 *
 * - Zero `<script server>` tags → `'ssg'` (static site, flat HTML in `dist/`)
 * - Any `<script server>` tag  → `'ssr'` (server bundle in `.output/`)
 */
export declare function detectBuildMode(root?: string): Promise<BuildModeDetectionResult>;
/**
 * Validate that components don't mix `<script server>` and `<script client>`.
 *
 * Components should be server OR client — compose them via props/slots.
 * Pages are allowed to have both (e.g. `<script server>` for SEO +
 * `<script client>` for interactivity).
 */
export declare function validateComponentScripts(root?: string): Promise<ComponentValidationError[]>;
export declare interface BuildModeDetectionResult {
  mode: BuildMode
  serverScriptFiles: string[]
  totalFilesScanned: number
  scanDurationMs: number
}
export declare interface ComponentValidationError {
  file: string
  message: string
}
export type BuildMode = 'ssg' | 'ssr';
