Function normalizeGeneratedFilePathSegment

src/utils/generatedFilePath.ts:98–124

(
	segment: string,
	label: string,
)

}

function normalizeGeneratedFilePathSegment(
	segment: string,
	label: string,
): string {
	if (segment.length === 0) return segment;

	const startsWithControl =
		STARTS_WITH_CONTROL_OR_LINE_SEPARATOR.test(segment);
	const endsWithControl = ENDS_WITH_CONTROL_OR_LINE_SEPARATOR.test(segment);
	let normalized = collapseControlRunsWithSpaces(segment);

	if (startsWithControl) normalized = normalized.replace(/^ /u, "");
	if (endsWithControl) normalized = normalized.replace(/ $/u, "");

	const withoutTrailingSpaces = trimTrailingCharsLinear(normalized, " ");
	if (withoutTrailingSpaces === "." || withoutTrailingSpaces === "..") {
		throw new Error(`${label} cannot contain "." or ".." path segments.`);
	}

	normalized = trimTrailingCharsLinear(normalized, ". ");

	if (!normalized) {
		throw new Error(`${label} contains an empty path segment after formatting.`);
	}

	return normalized;
}