Function resolveCaptureTarget

src/engine/helpers/captureTargetResolution.ts:49–129

(
	formattedCaptureTo: string,
	deps: CaptureTargetDeps,
)

 * 6) ambiguous => folder if it exists and no same-name file exists; else file
 */
export function resolveCaptureTarget(
	formattedCaptureTo: string,
	deps: CaptureTargetDeps,
): CaptureTargetResolution {
	const rawCaptureTo = formattedCaptureTo.trim().replace(/^\/+/, "");

	if (rawCaptureTo === "") {
		return { kind: "vault" };
	}

	// `property:<field>[=<value>]` pre-filters by a frontmatter field (issue #466).
	// Checked before the `.base`/extension/folder branches so a property value
	// containing `.md`/`/` (or a trailing `/`) can never misroute to a file/folder.
	const propertyTarget = parsePropertyTarget(rawCaptureTo);
	if (propertyTarget) {
		if (!propertyTarget.field) {
			throw new ChoiceAbortError(
				"Property capture target needs a field name, e.g. property:type=draft",
			);
		}
		return {
			kind: "property",
			field: propertyTarget.field,
			value: propertyTarget.value,
			filter: propertyTarget.filter,
		};
	}

	const fileFilterTarget = parseCaptureFileFilterTarget(rawCaptureTo);
	if (fileFilterTarget) {
		if (fileFilterTarget.multiSelect) {
			throw new ChoiceAbortError(
				"Capture target filters select one destination file. Use {{FILE:...|multi}} in the capture format for multi-value metadata.",
			);
		}
		return {
			kind: "filter",
			filter: fileFilterTarget.filter,
		};
	}

	const normalizedCaptureTo = normalizeGeneratedFilePath(
		rawCaptureTo,
		"Capture target file path",
	);

	if (BASE_FILE_EXTENSION_REGEX.test(normalizedCaptureTo)) {
		throw new ChoiceAbortError(
			`Capture to '.base' files is not supported (${normalizedCaptureTo}). Use a Template choice instead.`,
		);
	}

	const endsWithSlash = normalizedCaptureTo.endsWith("/");
	const folderPath = normalizedCaptureTo.replace(/\/+$/, "");

	if (endsWithSlash) {
		return { kind: "folder", folder: folderPath };
	}