Method normalizeRuntimeGroups

src/api/TaskNotesAPI.ts:1413–1459

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

	}

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

		const groups = value
			.map((entry, index): TaskNotesRuntimeNormalizedTaskQuery["group"][number] | null => {
				if (!isRecord(entry) || typeof entry["field"] !== "string") {
					issues.push({
						path: `$.group.${index}`,
						code: "group_invalid",
						message: "Runtime query group entries require a field.",
					});
					return null;
				}
				const field = this.resolveRuntimeQueryField(entry["field"]);
				if (!field || !field.definition.groupable) {
					issues.push({
						path: `$.group.${index}.field`,
						code: "group_field_unsupported",
						message: `Runtime query field is not groupable: ${entry["field"]}`,
					});
					return null;
				}
				return { field: field.definition.id };
			})
			.filter(isDefined);

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

	private runtimeQueryToFilterQuery(
		query: TaskNotesRuntimeNormalizedTaskQuery,