import { Type } from "typebox";

export const AskOptionSchema = Type.Object({
	value: Type.Optional(
		Type.String({
			description:
				"Required machine-readable value returned for this option in the result",
		})
	),
	label: Type.Optional(
		Type.String({
			description: "Required short visible option label shown in the list",
		})
	),
	description: Type.Optional(
		Type.String({
			description: "Optional one-line explanation to help the user choose",
		})
	),
	preview: Type.Optional(
		Type.String({
			description:
				"Optional preview content shown in the dedicated preview pane for preview questions",
		})
	),
});

export const AskQuestionSchema = Type.Object({
	id: Type.Optional(
		Type.String({
			description:
				"Required stable question identifier used as the key in returned answers",
		})
	),
	label: Type.Optional(
		Type.String({
			description: "Short tab label, e.g. Goal, Audience, Tone, Scope",
		})
	),
	prompt: Type.Optional(
		Type.String({
			description:
				"Required direct question shown to the user; ask about one decision at a time",
		})
	),
	type: Type.Optional(
		Type.String({
			description:
				"Question type: use `single` by default. Use `preview` only when every option includes `preview` text for the dedicated preview pane; descriptions alone are not enough.",
		})
	),
	required: Type.Optional(
		Type.Boolean({
			description:
				"Advisory only; marks the question as important but never blocks submission",
		})
	),
	options: Type.Array(AskOptionSchema, {
		description: "Answer options; prefer 2-4 clear choices when possible",
	}),
});

export const AskParamsSchema = Type.Object({
	title: Type.Optional(
		Type.String({
			description:
				"Optional short title shown above the clarification flow, e.g. README direction",
		})
	),
	questions: Type.Array(AskQuestionSchema, {
		description: "Questions to ask in the interactive clarification flow",
	}),
});