import type { CliOptions } from '../utils/config/cli-options';
import type { TreeNode } from '../utils/terminal/layout';
export declare const APP_CONFIG_JSON_FILE_NAME = "app.config.json";
/**
 * Updates the application configuration JSON by adding a new document entry to
 * `app.documents`, and writes the updated configuration to a template file.
 */
export declare function updateAppConfigJson(options: {
    appConfig: CliOptions;
    /** The `<name>` part of the document to register. */
    documentName: string;
    /** Has the current working directory */
    cwd: string;
    /** Whether to write to the filesystem or not */
    dryRun?: boolean;
    /** When true, suppress the per-write dry-run note (the caller emits it once). */
    suppressDryRunNote?: boolean;
}): Promise<TreeNode>;
/**
 * Builds the default `{ name, description }` values for a new document
 * config entry. Single source of truth shared by the JSON path (`addDocument`)
 * and the manual-update instructions (`buildManualUpdateInstructions`).
 * `configFileName` is used verbatim in the description text, so each caller
 * controls whether that reads as the actual config file name or a fixed
 * constant.
 */
export declare function buildDocumentEntryValues(documentName: string, configFileName: string): {
    name: string;
    description: string;
};
/**
 * Builds a clear, actionable message instructing the user to add the
 * `app.documents` entry manually. Used for `.ts`/`.cts`/`.js` app config files,
 * which are not modified automatically - the user is asked to register the new
 * document in their config source themselves.
 */
export declare function buildManualUpdateInstructions(configFileName: string, documentName: string): string;