Function classifyCaptureTargetScope

src/engine/helpers/captureTargetScope.ts:69–163

(
	deps: CaptureTargetScopeDeps,
	rawCaptureTo: string,
	captureToActiveFile: boolean,
)

 * legitimately collected pick is never silently dropped.
 */
export function classifyCaptureTargetScope(
	deps: CaptureTargetScopeDeps,
	rawCaptureTo: string,
	captureToActiveFile: boolean,
): CaptureTargetScope | null {
	if (captureToActiveFile) return null;

	const normalizedTarget = (rawCaptureTo ?? "").trim().replace(/^\/+/, "");

	// A target carrying a format token (e.g. `Projects/{{VALUE}}.md`,
	// `Notes/{{DATE}}/`, `#{{VALUE}}`) is only resolvable at run time, so in EVERY
	// shape - file, folder, tag, property - it is never a stable picker scope: it
	// gets no preflight requirement and the engine never honours a preselected pick
	// for it. Returning early keeps that uniform across all branches below.
	if (hasTemplatePathSyntax(normalizedTarget)) return null;

	const propertyTarget = parsePropertyTarget(normalizedTarget);
	const isPropertyTarget = !!propertyTarget && !!propertyTarget.field;

	const fileFilterTarget = !isPropertyTarget
		? parseCaptureFileFilterTarget(normalizedTarget)
		: null;
	// A multi-select filter is not a single-destination capture scope.
	const isFilterTarget = !!fileFilterTarget && !fileFilterTarget.multiSelect;

	const isTagTarget =
		!isPropertyTarget &&
		!fileFilterTarget &&
		normalizedTarget.startsWith("#");

	const endsWithSlash = normalizedTarget.endsWith("/");

	// A target carrying a recognized file extension with no trailing slash is never
	// a runtime-pick scope. This mirrors resolveCaptureTarget, which tests the
	// extension BEFORE the folder-ambiguity check, so an extensioned target that
	// happens to collide with a same-named folder is NOT misrouted to that folder
	// in either classifier. `.md`/`.canvas` are definite files; `.base` is
	// unsupported (the resolver throws on it downstream) - in all three cases the
	// engine must NOT honour an injected `__qa.captureTargetFilePath`, so returning
	// `null` here both stops the spurious folder prompt AND preserves the #1448
	// reserved-key confinement for a configured definite/unsupported file target.
	const hasRecognizedFileExtension =
		!isTagTarget &&
		!isPropertyTarget &&
		!isFilterTarget &&
		!endsWithSlash &&
		(MARKDOWN_FILE_EXTENSION_REGEX.test(normalizedTarget) ||
			CANVAS_FILE_EXTENSION_REGEX.test(normalizedTarget) ||
			BASE_FILE_EXTENSION_REGEX.test(normalizedTarget));

	const folderProbePath = normalizedTarget.replace(/\/+$/, "");
	// A bare name targets a folder only when the folder exists AND no same-name
	// note does (resolveCaptureTarget's disambiguation; docs: "if both Projects/
	// and Projects.md exist, Projects targets Projects.md"). Probing for the note
	// keeps the classifier from offering a folder pick - and honouring an injected
	// pick - for a bare name the write path resolves to a definite file. An empty
	// target is the whole-vault scope and needs no probe. A trailing-slash target
	// forces the folder regardless (handled by looksLikeFolderBySuffix below).