/**
 * Settings management for AXM workspace configuration.
 *
 * @experimental This API is unstable and may change without notice.
 * @packageDocumentation
 */
import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Schema from "effect/Schema";
import { type Settings } from "./schema.js";
import { applyJsonPatchToText } from "./format-preserving-json.js";
/**
 * Create default settings object.
 *
 * @experimental This API is unstable and may change without notice.
 */
export declare const createDefaultSettings: () => Settings;
type ExistingSettingsRenderResult = {
    readonly content: string;
    readonly fallbackReason?: "edit_failed" | "edited_content_invalid";
};
/** @internal */
export declare const renderExistingSettings: (priorText: string, prior: Schema.Json, target: Schema.Json, canonicalContent: string, applyPatch?: typeof applyJsonPatchToText) => ExistingSettingsRenderResult;
/**
 * Write settings to the selected scope's settings path.
 *
 * Creates the directory if it doesn't exist. Pretty-prints JSON with 2-space indent.
 *
 * @param settingsPath - Exact project or user settings path
 * @param settings - Settings object to write
 *
 * @experimental This API is unstable and may change without notice.
 */
export declare const writeSettingsAtPath: (settingsPath: string, settings: Settings) => Effect.Effect<void, import("../app-error/app-error.ts").AppError, Path.Path | FileSystem.FileSystem>;
export {};
//# sourceMappingURL=settings.d.ts.map