import type { PackageManagerId } from '../shared/package-managers.js';
/**
 * Inputs used to build CLI next-step commands after scaffolding succeeds.
 */
export interface ScaffoldNextStepsOptions {
    /**
     * Whether install instructions should be printed because install was skipped.
     */
    noInstall: boolean;
    /**
     * Package manager used to format install and run commands.
     */
    packageManager: PackageManagerId;
    /**
     * Absolute scaffold target directory.
     */
    projectDir: string;
    /**
     * Project path exactly as provided to the CLI.
     */
    projectInput: string;
    /**
     * Resolved template id used to choose the primary development script.
     */
    templateId: string;
}
/**
 * Inputs used to compute optional onboarding guidance after scaffolding.
 */
export interface ScaffoldOptionalOnboardingOptions {
    /**
     * Script names discovered from the generated package manifest.
     */
    availableScripts?: string[];
    /**
     * Package manager used to format optional commands.
     */
    packageManager: PackageManagerId;
    /**
     * Resolved template id used to select template-specific guidance.
     */
    templateId: string;
    /**
     * Whether compound persistence support is present in generated variables.
     */
    compoundPersistenceEnabled?: boolean;
}
/**
 * User-facing optional onboarding copy and command list.
 */
export interface OptionalOnboardingGuidance {
    /**
     * Full note shown in the detailed completion output.
     */
    note: string;
    /**
     * Short note shown in compact completion output.
     */
    shortNote: string;
    /**
     * Optional follow-up commands to show after next steps.
     */
    steps: string[];
}
/**
 * Build the printed next-step commands for a scaffolded project.
 *
 * @param options Project location and package-manager details used to format
 * next-step commands.
 * @returns Ordered shell commands shown after scaffolding succeeds.
 */
export declare function getNextSteps({ projectInput, projectDir, packageManager, noInstall, templateId }: ScaffoldNextStepsOptions): string[];
/**
 * Compute optional onboarding guidance shown after scaffolding completes.
 *
 * @param options Package-manager and template context for optional guidance.
 * @returns Optional onboarding note and step list.
 */
export declare function getOptionalOnboarding({ availableScripts, packageManager, templateId, compoundPersistenceEnabled }: ScaffoldOptionalOnboardingOptions): OptionalOnboardingGuidance;