package prettier

// Schema for .prettierrc
#Schema: {
	@jsonschema(schema="http://json-schema.org/draft-07/schema#")
	@jsonschema(id="https://www.schemastore.org/prettierrc.json")
	matchN(1, [#optionsDefinition & #overridesDefinition, string])

	#optionsDefinition: {
		// Include parentheses around a sole arrow function parameter.
		arrowParens?: matchN(1, ["always", "avoid"])

		// Put > of opening tags on the last line instead of on a new line.
		bracketSameLine?: bool

		// Print spaces between brackets.
		bracketSpacing?: bool

		// Check whether the file's first docblock comment contains '@noprettier' or
		// '@noformat' to determine if it should be formatted.
		checkIgnorePragma?: bool

		// Print (to stderr) where a cursor at the given position would move to after formatting.
		cursorOffset?: int

		// Control how Prettier formats quoted code embedded in the file.
		embeddedLanguageFormatting?: matchN(1, ["auto", "off"])

		// Which end of line characters to apply.
		endOfLine?: matchN(1, ["lf", "crlf", "cr", "auto"])

		// Where to print operators when binary expressions wrap lines.
		experimentalOperatorPosition?: matchN(1, ["start", "end"])

		// Use curious ternaries, with the question mark after the condition.
		experimentalTernaries?: bool

		// Specify the input filepath. This will be used to do parser inference.
		filepath?: string

		// How to handle whitespaces in HTML.
		htmlWhitespaceSensitivity?: matchN(1, ["css", "strict", "ignore"])

		// Insert @format pragma into file's first docblock comment.
		insertPragma?: bool

		// Use single quotes in JSX.
		jsxSingleQuote?: bool

		// How to wrap object literals.
		objectWrap?: matchN(1, ["preserve", "collapse"])

		// Which parser to use.
		parser?: matchN(>=1, [
			"flow",
			"babel",
			"babel-flow",
			"babel-ts",
			"typescript",
			"acorn",
			"espree",
			"meriyah",
			"css",
			"less",
			"scss",
			"json",
			"json5",
			"jsonc",
			"json-stringify",
			"graphql",
			"markdown",
			"mdx",
			"vue",
			"yaml",
			"glimmer",
			"html",
			"angular",
			"lwc",
			"mjml",
			string,
		])

		// Add a plugin. Multiple plugins can be passed as separate `--plugin`s.
		plugins?: [...string]

		// The line length where Prettier will try wrap.
		printWidth?: int

		// How to wrap prose.
		proseWrap?: matchN(1, ["always", "never", "preserve"])

		// Change when properties in objects are quoted.
		quoteProps?: matchN(1, ["as-needed", "consistent", "preserve"])

		// Format code ending at a given character offset (exclusive).
		// The range will extend forwards to the end of the selected statement.
		rangeEnd?: int

		// Format code starting at a given character offset.
		// The range will extend backwards to the start of the first line containing the selected statement.
		rangeStart?: int

		// Require either '@prettier' or '@format' to be present in the file's first
		// docblock comment in order for it to be formatted.
		requirePragma?: bool

		// Print semicolons.
		semi?: bool

		// Enforce single attribute per line in HTML, Vue and JSX.
		singleAttributePerLine?: bool

		// Use single quotes instead of double quotes.
		singleQuote?: bool

		// Number of spaces per indentation level.
		tabWidth?: int

		// Print trailing commas wherever possible when multi-line.
		trailingComma?: matchN(1, ["all", "es5", "none"])

		// Indent with tabs instead of spaces.
		useTabs?: bool

		// Indent script and style tags in Vue files.
		vueIndentScriptAndStyle?: bool
		...
	}

	#overridesDefinition: {
		// Provide a list of patterns to override prettier configuration.
		overrides?: [...close({
			// Include these files in this override.
			files!: matchN(1, [string, [...string]])

			// Exclude these files from this override.
			excludeFiles?: matchN(1, [string, [...string]])
			options?:      #optionsDefinition
		})]
		...
	}
}