Function parsePropertyTarget

src/utils/propertyTarget.ts:45–68

(raw: string)

 * preflight, so the two paths can never disagree on what is a property target.
 */
export function parsePropertyTarget(raw: string): PropertyTarget | null {
	const trimmed = raw.trim();
	if (!PROPERTY_PREFIX.test(trimmed)) return null;

	const interior = trimmed.replace(PROPERTY_PREFIX, "");

	// Reuse the shared FIELD pipe grammar: the parser splits on `|`, treats the
	// first part as the "field name" (here our `field=value` core) and parses the
	// rest as folder/tag/exclude-* filters — identical to {{FILE:}}/{{FIELD:}}.
	// Only folder / tag / exclude-folder / exclude-tag / exclude-file are honored
	// by the property query (see getMarkdownFilesWithProperty); other FIELD options
	// the parser accepts (default:/inline:/case-sensitive:) are inert here — value
	// matching is always case-insensitive by design.
	const { fieldName: core, filters } = FieldSuggestionParser.parse(interior);

	const eq = core.indexOf("=");
	const field = (eq >= 0 ? core.slice(0, eq) : core).trim();
	// Split on the FIRST `=`, so values may contain further `=` (e.g. `a=b`).
	const rawValue = eq >= 0 ? core.slice(eq + 1).trim() : "";
	// Empty value (`property:type` or `property:type=`) → presence mode.
	const value = rawValue.length > 0 ? rawValue : undefined;

	return { field, value, filter: filters };
}