Method normalizeRuntimeSorts

src/api/TaskNotesAPI.ts:1364–1411

(
		value: unknown,
		issues: TaskNotesRuntimeQueryIssue[],
		warnings: TaskNotesRuntimeQueryWarning[]
	)

	}

	private normalizeRuntimeSorts(
		value: unknown,
		issues: TaskNotesRuntimeQueryIssue[],
		warnings: TaskNotesRuntimeQueryWarning[]
	): TaskNotesRuntimeNormalizedTaskQuery["sort"] {
		if (typeof value === "undefined") return [];
		if (!Array.isArray(value)) {
			issues.push({
				path: "$.sort",
				code: "sort_not_array",
				message: "Runtime query sort must be an array.",
			});
			return [];
		}

		const sorts = value
			.map((entry, index): TaskNotesRuntimeNormalizedTaskQuery["sort"][number] | null => {
				if (!isRecord(entry) || typeof entry["field"] !== "string") {
					issues.push({
						path: `$.sort.${index}`,
						code: "sort_invalid",
						message: "Runtime query sort entries require a field.",
					});
					return null;
				}
				const field = this.resolveRuntimeQueryField(entry["field"]);
				if (!field || !field.definition.sortable) {
					issues.push({
						path: `$.sort.${index}.field`,
						code: "sort_field_unsupported",
						message: `Runtime query field is not sortable: ${entry["field"]}`,
					});
					return null;
				}
				const direction = entry["direction"] === "desc" ? "desc" : "asc";
				return { field: field.definition.id, direction };
			})
			.filter(isDefined);

		if (sorts.length > 1) {
			warnings.push({
				path: "$.sort",
				code: "multiple_sorts",
				message: "Only the first sort is currently applied by TaskNotes.",
			});
		}
		return sorts;
	}

	private normalizeRuntimeGroups(
		value: unknown,