Method suggestForField

src/formatters/completeFormatter.ts:734–898

(fieldInput: string)

	}

	protected async suggestForField(fieldInput: string): Promise<string | string[]> {
		this.assertInteractivePrompt(`{{FIELD:${fieldInput}}}`);
		// Route the final picker to a remote interactive session (Raycast) when one
		// is driving; the vault-side value collection below still runs unchanged.
		const provider = this.choiceExecutor?.promptProvider;
		try {
			// Parse the field input to extract field name and filters. Do NOT warn
			// on unknown keys here: the field replacer in formatter.ts already parses
			// the same token with { warnUnknown: true } before calling this, so
			// warning again would emit a duplicate notice per malformed FIELD token.
			const { fieldName, filters, multiSelect } =
				FieldSuggestionParser.parse(fieldInput);

			// Resolve the active-note default (issue #1429) BEFORE collection but apply
			// it AFTER, so the resolved value never enters the collection cache key
			// (which is keyed partly on filters.defaultValue). Gate strictly on
			// "active"; an unknown source is ignored. `null` => no usable active value
			// (no/non-Markdown active file, or a missing/empty/object property).
			const activeDefault =
				filters.defaultFrom === "active"
					? resolveActiveNoteFieldDefault(
							this.app,
							this.choiceExecutor?.triggerContext?.activeFile ?? null,
							fieldName,
						)
					: null;

			// Collect and process via shared collector (filters unmutated).
			const { values: collectedValues, hasDefaultValue: literalHasDefault } =
				await collectFieldValuesProcessedDetailed(this.app, fieldName, filters);

			let values = collectedValues;
			let hasDefaultValue = literalHasDefault;
			// The default shown in the placeholder hint: the active-note value wins
			// over a literal |default: when both are present.
			let effectiveDefault = filters.defaultValue;

			if (!multiSelect && typeof activeDefault === "string") {
				// Promote the active note's scalar value to the top so an empty-query
				// Enter accepts it, matching the existing default-always semantics.
				values = FieldValueProcessor.promoteValueToFront(
					values,
					activeDefault,
					filters.caseSensitive,
				);
				effectiveDefault = activeDefault;
				hasDefaultValue = true;
			} else if (
				!multiSelect &&
				Array.isArray(activeDefault) &&
				activeDefault.length > 0
			) {
				// A list-valued property has no single default; lists apply to |multi
				// only. Log (console-only) so a user expecting a default isn't mystified.
				log.logMessage(
					`{{FIELD:${fieldName}|default-from:active}}: the active note's "${fieldName}" is a list value, which applies only to |multi FIELD prompts, so no default was prefilled.`,
				);
			}