@benjavicente/router-generator 1.166.24

package/dist/esm/transform/transform.js

@@ -0,0 +1,301 @@
+import { mergeImportDeclarations } from "../utils.js";
+import { ensureStringArgument } from "./utils.js";
+import { parseAst } from "@benjavicente/router-utils";
+import { parse, print, types, visit } from "recast";
+import { SourceMapConsumer } from "source-map";
+//#region src/transform/transform.ts
+var b = types.builders;
+async function transform({ ctx, source, node }) {
+	let appliedChanges = false;
+	let ast;
+	try {
+		ast = parse(source, {
+			sourceFileName: "output.ts",
+			parser: { parse(code) {
+				return parseAst({
+					code,
+					tokens: true
+				});
+			} }
+		});
+	} catch (e) {
+		console.error("Error parsing code", ctx.routeId, source, e);
+		return {
+			result: "error",
+			error: e
+		};
+	}
+	const preferredQuote = detectPreferredQuoteStyle(ast);
+	let routeExportHandled = false;
+	function onExportFound(decl) {
+		if (decl.init?.type === "CallExpression") {
+			const callExpression = decl.init;
+			const firstArgument = callExpression.arguments[0];
+			if (firstArgument) {
+				if (firstArgument.type === "ObjectExpression") {
+					const staticProperties = firstArgument.properties.flatMap((p) => {
+						if (p.type === "ObjectProperty" && p.key.type === "Identifier") return p.key.name;
+						return [];
+					});
+					node.createFileRouteProps = new Set(staticProperties);
+				}
+			}
+			let identifier;
+			if (callExpression.callee.type === "Identifier") {
+				identifier = callExpression.callee;
+				if (ctx.verboseFileRoutes) {
+					callExpression.callee = b.callExpression(identifier, [b.stringLiteral(ctx.routeId)]);
+					appliedChanges = true;
+				}
+			} else if (callExpression.callee.type === "CallExpression" && callExpression.callee.callee.type === "Identifier") {
+				identifier = callExpression.callee.callee;
+				if (!ctx.verboseFileRoutes) {
+					callExpression.callee = identifier;
+					appliedChanges = true;
+				} else appliedChanges = ensureStringArgument(callExpression.callee, ctx.routeId, ctx.preferredQuote);
+			}
+			if (identifier === void 0) throw new Error(`expected identifier to be present in ${ctx.routeId} for export "Route"`);
+			if (identifier.name === "createFileRoute" && ctx.lazy) {
+				identifier.name = "createLazyFileRoute";
+				appliedChanges = true;
+			} else if (identifier.name === "createLazyFileRoute" && !ctx.lazy) {
+				identifier.name = "createFileRoute";
+				appliedChanges = true;
+			}
+		} else throw new Error(`expected "Route" export to be initialized by a CallExpression`);
+		routeExportHandled = true;
+	}
+	const program = ast.program;
+	for (const n of program.body) {
+		if (n.type === "ExportNamedDeclaration") {
+			if (n.declaration?.type === "VariableDeclaration") {
+				const decl = n.declaration.declarations[0];
+				if (decl && decl.type === "VariableDeclarator" && decl.id.type === "Identifier") {
+					if (decl.id.name === "Route") onExportFound(decl);
+				}
+			} else if (n.declaration === null && n.specifiers) {
+				for (const spec of n.specifiers) if (typeof spec.exported.name === "string") {
+					if (spec.exported.name === "Route") {
+						const variableName = spec.local?.name || spec.exported.name;
+						for (const decl of program.body) if (decl.type === "VariableDeclaration" && decl.declarations[0]) {
+							const variable = decl.declarations[0];
+							if (variable.type === "VariableDeclarator" && variable.id.type === "Identifier" && variable.id.name === variableName) {
+								onExportFound(variable);
+								break;
+							}
+						}
+					}
+				}
+			}
+		}
+		if (routeExportHandled) break;
+	}
+	if (!routeExportHandled) return { result: "no-route-export" };
+	const imports = {
+		required: [],
+		banned: []
+	};
+	const targetModule = ctx.target === "angular" ? ctx.angularRouterPackage ?? "@benjavicente/angular-router-experimental" : `@benjavicente/${ctx.target}-router`;
+	if (ctx.verboseFileRoutes === false) imports.banned = [{
+		source: targetModule,
+		specifiers: [{ imported: "createLazyFileRoute" }, { imported: "createFileRoute" }]
+	}];
+	else if (ctx.lazy) {
+		imports.required = [{
+			source: targetModule,
+			specifiers: [{ imported: "createLazyFileRoute" }]
+		}];
+		imports.banned = [{
+			source: targetModule,
+			specifiers: [{ imported: "createFileRoute" }]
+		}];
+	} else {
+		imports.required = [{
+			source: targetModule,
+			specifiers: [{ imported: "createFileRoute" }]
+		}];
+		imports.banned = [{
+			source: targetModule,
+			specifiers: [{ imported: "createLazyFileRoute" }]
+		}];
+	}
+	imports.required = mergeImportDeclarations(imports.required);
+	imports.banned = mergeImportDeclarations(imports.banned);
+	const importStatementCandidates = [];
+	const importDeclarationsToRemove = [];
+	for (const n of program.body) {
+		const findImport = (opts) => (i) => {
+			if (i.source === opts.source) {
+				const importKind = i.importKind || "value";
+				return (opts.importKind || "value") === importKind;
+			}
+			return false;
+		};
+		if (n.type === "ImportDeclaration" && typeof n.source.value === "string") {
+			const filterImport = findImport({
+				source: n.source.value,
+				importKind: n.importKind
+			});
+			let requiredImports = imports.required.filter(filterImport)[0];
+			const bannedImports = imports.banned.filter(filterImport)[0];
+			if (!requiredImports && !bannedImports) continue;
+			const importSpecifiersToRemove = [];
+			if (n.specifiers) {
+				for (const spec of n.specifiers) {
+					if (!requiredImports && !bannedImports) break;
+					if (spec.type === "ImportSpecifier" && typeof spec.imported.name === "string") {
+						if (requiredImports) {
+							const requiredImportIndex = requiredImports.specifiers.findIndex((imp) => imp.imported === spec.imported.name);
+							if (requiredImportIndex !== -1) {
+								requiredImports.specifiers.splice(requiredImportIndex, 1);
+								if (requiredImports.specifiers.length === 0) {
+									const reqIdx = imports.required.indexOf(requiredImports);
+									if (reqIdx !== -1) imports.required.splice(reqIdx, 1);
+									requiredImports = void 0;
+								}
+							} else if (requiredImports.specifiers.length > 0) importStatementCandidates.push(n);
+						}
+						if (bannedImports) {
+							if (bannedImports.specifiers.findIndex((imp) => imp.imported === spec.imported.name) !== -1) importSpecifiersToRemove.push(spec);
+						}
+					}
+				}
+				if (importSpecifiersToRemove.length > 0) {
+					appliedChanges = true;
+					n.specifiers = n.specifiers.filter((spec) => !importSpecifiersToRemove.includes(spec));
+					if (n.specifiers.length === 0) importDeclarationsToRemove.push(n);
+				}
+			}
+		}
+	}
+	imports.required.forEach((requiredImport) => {
+		if (requiredImport.specifiers.length > 0) {
+			appliedChanges = true;
+			if (importStatementCandidates.length > 0) {
+				const importStatement = importStatementCandidates.find((importStatement) => {
+					if (importStatement.source.value === requiredImport.source) return (importStatement.importKind || "value") === (requiredImport.importKind || "value");
+					return false;
+				});
+				if (importStatement) {
+					if (importStatement.specifiers === void 0) importStatement.specifiers = [];
+					const importSpecifiersToAdd = requiredImport.specifiers.map((spec) => b.importSpecifier(b.identifier(spec.imported), b.identifier(spec.imported)));
+					importStatement.specifiers = [...importStatement.specifiers, ...importSpecifiersToAdd];
+					return;
+				}
+			}
+			const importStatement = b.importDeclaration(requiredImport.specifiers.map((spec) => b.importSpecifier(b.identifier(spec.imported), spec.local ? b.identifier(spec.local) : null)), b.stringLiteral(requiredImport.source));
+			program.body.unshift(importStatement);
+		}
+	});
+	if (importDeclarationsToRemove.length > 0) {
+		appliedChanges = true;
+		for (const importDeclaration of importDeclarationsToRemove) if (importDeclaration.specifiers?.length === 0) {
+			const index = program.body.indexOf(importDeclaration);
+			if (index !== -1) program.body.splice(index, 1);
+		}
+	}
+	if (!appliedChanges) return { result: "not-modified" };
+	const printResult = print(ast, {
+		reuseWhitespace: true,
+		sourceMapName: "output.map"
+	});
+	let transformedCode = printResult.code;
+	if (printResult.map) transformedCode = await fixTransformedOutputText({
+		originalCode: source,
+		transformedCode,
+		sourceMap: printResult.map,
+		preferredQuote
+	});
+	return {
+		result: "modified",
+		output: transformedCode
+	};
+}
+async function fixTransformedOutputText({ originalCode, transformedCode, sourceMap, preferredQuote }) {
+	const originalLines = originalCode.split("\n");
+	const transformedLines = transformedCode.split("\n");
+	const defaultUsesSemicolons = detectSemicolonUsage(originalCode);
+	const consumer = await new SourceMapConsumer(sourceMap);
+	return transformedLines.map((line, i) => {
+		const transformedLineNum = i + 1;
+		let origLineText = void 0;
+		for (let col = 0; col < line.length; col++) {
+			const mapped = consumer.originalPositionFor({
+				line: transformedLineNum,
+				column: col
+			});
+			if (mapped.line != null && mapped.line > 0) {
+				origLineText = originalLines[mapped.line - 1];
+				break;
+			}
+		}
+		if (origLineText !== void 0) {
+			if (origLineText === line) return origLineText;
+			return fixLine(line, {
+				originalLine: origLineText,
+				useOriginalSemicolon: true,
+				useOriginalQuotes: true,
+				fallbackQuote: preferredQuote
+			});
+		} else return fixLine(line, {
+			originalLine: null,
+			useOriginalSemicolon: false,
+			useOriginalQuotes: false,
+			fallbackQuote: preferredQuote,
+			fallbackSemicolon: defaultUsesSemicolons
+		});
+	}).join("\n");
+}
+function fixLine(line, { originalLine, useOriginalSemicolon, useOriginalQuotes, fallbackQuote, fallbackSemicolon = true }) {
+	let result = line;
+	if (useOriginalQuotes && originalLine) result = fixQuotes(result, originalLine, fallbackQuote);
+	else if (!useOriginalQuotes && fallbackQuote) result = fixQuotesToPreferred(result, fallbackQuote);
+	if (useOriginalSemicolon && originalLine) {
+		const hadSemicolon = originalLine.trimEnd().endsWith(";");
+		const hasSemicolon = result.trimEnd().endsWith(";");
+		if (hadSemicolon && !hasSemicolon) result += ";";
+		if (!hadSemicolon && hasSemicolon) result = result.replace(/;\s*$/, "");
+	} else if (!useOriginalSemicolon) {
+		const hasSemicolon = result.trimEnd().endsWith(";");
+		if (!fallbackSemicolon && hasSemicolon) result = result.replace(/;\s*$/, "");
+		if (fallbackSemicolon && !hasSemicolon && result.trim()) result += ";";
+	}
+	return result;
+}
+function fixQuotes(line, originalLine, fallbackQuote) {
+	let originalQuote = detectQuoteFromLine(originalLine);
+	if (!originalQuote) originalQuote = fallbackQuote;
+	return fixQuotesToPreferred(line, originalQuote);
+}
+function fixQuotesToPreferred(line, quote) {
+	return line.replace(/(['"`])([^'"`\\]*(?:\\.[^'"`\\]*)*)\1/g, (_, q, content) => {
+		return `${quote}${content.replaceAll(quote, `\\${quote}`)}${quote}`;
+	});
+}
+function detectQuoteFromLine(line) {
+	const match = line.match(/(['"`])(?:\\.|[^\\])*?\1/);
+	return match ? match[1] : null;
+}
+function detectSemicolonUsage(code) {
+	const lines = code.split("\n").map((l) => l.trim());
+	const total = lines.length;
+	return lines.filter((l) => l.endsWith(";")).length > total / 2;
+}
+function detectPreferredQuoteStyle(ast) {
+	let single = 0;
+	let double = 0;
+	visit(ast, { visitStringLiteral(path) {
+		if (path.parent.node.type !== "JSXAttribute") {
+			const raw = path.node.extra?.raw;
+			if (raw?.startsWith("'")) single++;
+			else if (raw?.startsWith("\"")) double++;
+		}
+		return false;
+	} });
+	if (single >= double) return "'";
+	return "\"";
+}
+//#endregion
+export { transform };
+
+//# sourceMappingURL=transform.js.map

package/dist/esm/transform/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","names":[],"sources":["../../../src/transform/transform.ts"],"sourcesContent":["import { parseAst } from '@benjavicente/router-utils'\nimport { parse, print, types, visit } from 'recast'\nimport { SourceMapConsumer } from 'source-map'\nimport { mergeImportDeclarations } from '../utils'\nimport { ensureStringArgument } from './utils'\nimport type { ImportDeclaration } from '../types'\nimport type { RawSourceMap } from 'source-map'\nimport type { TransformOptions, TransformResult } from './types'\n\nconst b = types.builders\n\nexport async function transform({\n  ctx,\n  source,\n  node,\n}: TransformOptions): Promise<TransformResult> {\n  let appliedChanges = false as boolean\n  let ast: types.namedTypes.File\n  try {\n    ast = parse(source, {\n      sourceFileName: 'output.ts',\n      parser: {\n        parse(code: string) {\n          return parseAst({\n            code,\n            // we need to instruct babel to produce tokens,\n            // otherwise recast will try to generate the tokens via its own parser and will fail\n            tokens: true,\n          })\n        },\n      },\n    })\n  } catch (e) {\n    console.error('Error parsing code', ctx.routeId, source, e)\n    return {\n      result: 'error',\n      error: e,\n    }\n  }\n\n  const preferredQuote = detectPreferredQuoteStyle(ast)\n\n  let routeExportHandled = false as boolean\n  function onExportFound(decl: types.namedTypes.VariableDeclarator) {\n    if (decl.init?.type === 'CallExpression') {\n      const callExpression = decl.init\n      const firstArgument = callExpression.arguments[0]\n      if (firstArgument) {\n        if (firstArgument.type === 'ObjectExpression') {\n          const staticProperties = firstArgument.properties.flatMap((p) => {\n            if (p.type === 'ObjectProperty' && p.key.type === 'Identifier') {\n              return p.key.name\n            }\n            return []\n          })\n          node.createFileRouteProps = new Set(staticProperties)\n        }\n      }\n      let identifier: types.namedTypes.Identifier | undefined\n      // `const Route = createFileRoute({ ... })`\n      if (callExpression.callee.type === 'Identifier') {\n        identifier = callExpression.callee\n        if (ctx.verboseFileRoutes) {\n          // we need to add the string literal via another CallExpression\n          callExpression.callee = b.callExpression(identifier, [\n            b.stringLiteral(ctx.routeId),\n          ])\n          appliedChanges = true\n        }\n      }\n      // `const Route = createFileRoute('/path')({ ... })`\n      else if (\n        callExpression.callee.type === 'CallExpression' &&\n        callExpression.callee.callee.type === 'Identifier'\n      ) {\n        identifier = callExpression.callee.callee\n        if (!ctx.verboseFileRoutes) {\n          // we need to remove the route id\n          callExpression.callee = identifier\n          appliedChanges = true\n        } else {\n          // check if the route id is correct\n          appliedChanges = ensureStringArgument(\n            callExpression.callee,\n            ctx.routeId,\n            ctx.preferredQuote,\n          )\n        }\n      }\n      if (identifier === undefined) {\n        throw new Error(\n          `expected identifier to be present in ${ctx.routeId} for export \"Route\"`,\n        )\n      }\n      if (identifier.name === 'createFileRoute' && ctx.lazy) {\n        identifier.name = 'createLazyFileRoute'\n        appliedChanges = true\n      } else if (identifier.name === 'createLazyFileRoute' && !ctx.lazy) {\n        identifier.name = 'createFileRoute'\n        appliedChanges = true\n      }\n    } else {\n      throw new Error(\n        `expected \"Route\" export to be initialized by a CallExpression`,\n      )\n    }\n    routeExportHandled = true\n  }\n\n  const program: types.namedTypes.Program = ast.program\n  // first pass: find Route export\n  for (const n of program.body) {\n    if (n.type === 'ExportNamedDeclaration') {\n      // direct export of a variable declaration, e.g. `export const Route = createFileRoute('/path')`\n      if (n.declaration?.type === 'VariableDeclaration') {\n        const decl = n.declaration.declarations[0]\n        if (\n          decl &&\n          decl.type === 'VariableDeclarator' &&\n          decl.id.type === 'Identifier'\n        ) {\n          if (decl.id.name === 'Route') {\n            onExportFound(decl)\n          }\n        }\n      }\n      // this is an export without a declaration, e.g. `export { Route }`\n      else if (n.declaration === null && n.specifiers) {\n        for (const spec of n.specifiers) {\n          if (typeof spec.exported.name === 'string') {\n            if (spec.exported.name === 'Route') {\n              const variableName = spec.local?.name || spec.exported.name\n              // find the matching variable declaration by iterating over the top-level declarations\n              for (const decl of program.body) {\n                if (\n                  decl.type === 'VariableDeclaration' &&\n                  decl.declarations[0]\n                ) {\n                  const variable = decl.declarations[0]\n                  if (\n                    variable.type === 'VariableDeclarator' &&\n                    variable.id.type === 'Identifier' &&\n                    variable.id.name === variableName\n                  ) {\n                    onExportFound(variable)\n                    break\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n    if (routeExportHandled) {\n      break\n    }\n  }\n\n  if (!routeExportHandled) {\n    return {\n      result: 'no-route-export',\n    }\n  }\n\n  const imports: {\n    required: Array<ImportDeclaration>\n    banned: Array<ImportDeclaration>\n  } = {\n    required: [],\n    banned: [],\n  }\n\n  const targetModule =\n    ctx.target === 'angular'\n      ? (ctx.angularRouterPackage ??\n        '@benjavicente/angular-router-experimental')\n      : `@benjavicente/${ctx.target}-router`\n\n  if (ctx.verboseFileRoutes === false) {\n    imports.banned = [\n      {\n        source: targetModule,\n        specifiers: [\n          { imported: 'createLazyFileRoute' },\n          { imported: 'createFileRoute' },\n        ],\n      },\n    ]\n  } else {\n    if (ctx.lazy) {\n      imports.required = [\n        {\n          source: targetModule,\n          specifiers: [{ imported: 'createLazyFileRoute' }],\n        },\n      ]\n      imports.banned = [\n        {\n          source: targetModule,\n          specifiers: [{ imported: 'createFileRoute' }],\n        },\n      ]\n    } else {\n      imports.required = [\n        {\n          source: targetModule,\n          specifiers: [{ imported: 'createFileRoute' }],\n        },\n      ]\n      imports.banned = [\n        {\n          source: targetModule,\n          specifiers: [{ imported: 'createLazyFileRoute' }],\n        },\n      ]\n    }\n  }\n\n  imports.required = mergeImportDeclarations(imports.required)\n  imports.banned = mergeImportDeclarations(imports.banned)\n\n  const importStatementCandidates: Array<types.namedTypes.ImportDeclaration> =\n    []\n  const importDeclarationsToRemove: Array<types.namedTypes.ImportDeclaration> =\n    []\n\n  // second pass: apply import rules, but only if a matching export for the plugin was found\n  for (const n of program.body) {\n    const findImport =\n      (opts: { source: string; importKind?: 'type' | 'value' | 'typeof' }) =>\n      (i: ImportDeclaration) => {\n        if (i.source === opts.source) {\n          const importKind = i.importKind || 'value'\n          const expectedImportKind = opts.importKind || 'value'\n          return expectedImportKind === importKind\n        }\n        return false\n      }\n    if (n.type === 'ImportDeclaration' && typeof n.source.value === 'string') {\n      const filterImport = findImport({\n        source: n.source.value,\n        importKind: n.importKind,\n      })\n      let requiredImports = imports.required.filter(filterImport)[0]\n\n      const bannedImports = imports.banned.filter(filterImport)[0]\n      if (!requiredImports && !bannedImports) {\n        continue\n      }\n      const importSpecifiersToRemove: types.namedTypes.ImportDeclaration['specifiers'] =\n        []\n      if (n.specifiers) {\n        for (const spec of n.specifiers) {\n          if (!requiredImports && !bannedImports) {\n            break\n          }\n          if (\n            spec.type === 'ImportSpecifier' &&\n            typeof spec.imported.name === 'string'\n          ) {\n            if (requiredImports) {\n              const requiredImportIndex = requiredImports.specifiers.findIndex(\n                (imp) => imp.imported === spec.imported.name,\n              )\n              if (requiredImportIndex !== -1) {\n                // import is already present, remove it from requiredImports\n                requiredImports.specifiers.splice(requiredImportIndex, 1)\n                if (requiredImports.specifiers.length === 0) {\n                  const reqIdx = imports.required.indexOf(requiredImports)\n                  if (reqIdx !== -1) {\n                    imports.required.splice(reqIdx, 1)\n                  }\n                  requiredImports = undefined\n                }\n              } else if (requiredImports.specifiers.length > 0) {\n                // add the import statement to the candidates\n                importStatementCandidates.push(n)\n              }\n            }\n            if (bannedImports) {\n              const bannedImportIndex = bannedImports.specifiers.findIndex(\n                (imp) => imp.imported === spec.imported.name,\n              )\n              if (bannedImportIndex !== -1) {\n                importSpecifiersToRemove.push(spec)\n              }\n            }\n          }\n        }\n        if (importSpecifiersToRemove.length > 0) {\n          appliedChanges = true\n          n.specifiers = n.specifiers.filter(\n            (spec) => !importSpecifiersToRemove.includes(spec),\n          )\n\n          // mark the import statement as to be deleted if it is now empty\n          if (n.specifiers.length === 0) {\n            importDeclarationsToRemove.push(n)\n          }\n        }\n      }\n    }\n  }\n  imports.required.forEach((requiredImport) => {\n    if (requiredImport.specifiers.length > 0) {\n      appliedChanges = true\n      if (importStatementCandidates.length > 0) {\n        // find the first import statement that matches both the module and the import kind\n        const importStatement = importStatementCandidates.find(\n          (importStatement) => {\n            if (importStatement.source.value === requiredImport.source) {\n              const importKind = importStatement.importKind || 'value'\n              const requiredImportKind = requiredImport.importKind || 'value'\n              return importKind === requiredImportKind\n            }\n            return false\n          },\n        )\n        if (importStatement) {\n          if (importStatement.specifiers === undefined) {\n            importStatement.specifiers = []\n          }\n          const importSpecifiersToAdd = requiredImport.specifiers.map((spec) =>\n            b.importSpecifier(\n              b.identifier(spec.imported),\n              b.identifier(spec.imported),\n            ),\n          )\n          importStatement.specifiers = [\n            ...importStatement.specifiers,\n            ...importSpecifiersToAdd,\n          ]\n          return\n        }\n      }\n      const importStatement = b.importDeclaration(\n        requiredImport.specifiers.map((spec) =>\n          b.importSpecifier(\n            b.identifier(spec.imported),\n            spec.local ? b.identifier(spec.local) : null,\n          ),\n        ),\n        b.stringLiteral(requiredImport.source),\n      )\n      program.body.unshift(importStatement)\n    }\n  })\n  if (importDeclarationsToRemove.length > 0) {\n    appliedChanges = true\n    for (const importDeclaration of importDeclarationsToRemove) {\n      // check if the import declaration is still empty\n      if (importDeclaration.specifiers?.length === 0) {\n        const index = program.body.indexOf(importDeclaration)\n        if (index !== -1) {\n          program.body.splice(index, 1)\n        }\n      }\n    }\n  }\n\n  if (!appliedChanges) {\n    return {\n      result: 'not-modified',\n    }\n  }\n\n  const printResult = print(ast, {\n    reuseWhitespace: true,\n    sourceMapName: 'output.map',\n  })\n  let transformedCode = printResult.code\n  if (printResult.map) {\n    const fixedOutput = await fixTransformedOutputText({\n      originalCode: source,\n      transformedCode,\n      sourceMap: printResult.map as RawSourceMap,\n      preferredQuote,\n    })\n    transformedCode = fixedOutput\n  }\n  return {\n    result: 'modified',\n    output: transformedCode,\n  }\n}\n\nasync function fixTransformedOutputText({\n  originalCode,\n  transformedCode,\n  sourceMap,\n  preferredQuote,\n}: {\n  originalCode: string\n  transformedCode: string\n  sourceMap: RawSourceMap\n  preferredQuote: '\"' | \"'\"\n}) {\n  const originalLines = originalCode.split('\\n')\n  const transformedLines = transformedCode.split('\\n')\n\n  const defaultUsesSemicolons = detectSemicolonUsage(originalCode)\n\n  const consumer = await new SourceMapConsumer(sourceMap)\n\n  const fixedLines = transformedLines.map((line, i) => {\n    const transformedLineNum = i + 1\n\n    let origLineText: string | undefined = undefined\n\n    for (let col = 0; col < line.length; col++) {\n      const mapped = consumer.originalPositionFor({\n        line: transformedLineNum,\n        column: col,\n      })\n      if (mapped.line != null && mapped.line > 0) {\n        origLineText = originalLines[mapped.line - 1]\n        break\n      }\n    }\n\n    if (origLineText !== undefined) {\n      if (origLineText === line) {\n        return origLineText\n      }\n      return fixLine(line, {\n        originalLine: origLineText,\n        useOriginalSemicolon: true,\n        useOriginalQuotes: true,\n        fallbackQuote: preferredQuote,\n      })\n    } else {\n      return fixLine(line, {\n        originalLine: null,\n        useOriginalSemicolon: false,\n        useOriginalQuotes: false,\n        fallbackQuote: preferredQuote,\n        fallbackSemicolon: defaultUsesSemicolons,\n      })\n    }\n  })\n\n  return fixedLines.join('\\n')\n}\n\nfunction fixLine(\n  line: string,\n  {\n    originalLine,\n    useOriginalSemicolon,\n    useOriginalQuotes,\n    fallbackQuote,\n    fallbackSemicolon = true,\n  }: {\n    originalLine: string | null\n    useOriginalSemicolon: boolean\n    useOriginalQuotes: boolean\n    fallbackQuote: string\n    fallbackSemicolon?: boolean\n  },\n) {\n  let result = line\n\n  if (useOriginalQuotes && originalLine) {\n    result = fixQuotes(result, originalLine, fallbackQuote)\n  } else if (!useOriginalQuotes && fallbackQuote) {\n    result = fixQuotesToPreferred(result, fallbackQuote)\n  }\n\n  if (useOriginalSemicolon && originalLine) {\n    const hadSemicolon = originalLine.trimEnd().endsWith(';')\n    const hasSemicolon = result.trimEnd().endsWith(';')\n    if (hadSemicolon && !hasSemicolon) result += ';'\n    if (!hadSemicolon && hasSemicolon) result = result.replace(/;\\s*$/, '')\n  } else if (!useOriginalSemicolon) {\n    const hasSemicolon = result.trimEnd().endsWith(';')\n    if (!fallbackSemicolon && hasSemicolon) result = result.replace(/;\\s*$/, '')\n    if (fallbackSemicolon && !hasSemicolon && result.trim()) result += ';'\n  }\n\n  return result\n}\n\nfunction fixQuotes(line: string, originalLine: string, fallbackQuote: string) {\n  let originalQuote = detectQuoteFromLine(originalLine)\n  if (!originalQuote) {\n    originalQuote = fallbackQuote\n  }\n  return fixQuotesToPreferred(line, originalQuote)\n}\n\nfunction fixQuotesToPreferred(line: string, quote: string) {\n  // Replace existing quotes with preferred quote\n  return line.replace(\n    /(['\"`])([^'\"`\\\\]*(?:\\\\.[^'\"`\\\\]*)*)\\1/g,\n    (_, q, content) => {\n      const escaped = content.replaceAll(quote, `\\\\${quote}`)\n      return `${quote}${escaped}${quote}`\n    },\n  )\n}\n\nfunction detectQuoteFromLine(line: string) {\n  const match = line.match(/(['\"`])(?:\\\\.|[^\\\\])*?\\1/)\n  return match ? match[1] : null\n}\n\nfunction detectSemicolonUsage(code: string) {\n  const lines = code.split('\\n').map((l) => l.trim())\n  const total = lines.length\n  const withSemis = lines.filter((l) => l.endsWith(';')).length\n  return withSemis > total / 2\n}\n\nexport function detectPreferredQuoteStyle(ast: types.ASTNode): \"'\" | '\"' {\n  let single = 0\n  let double = 0\n\n  visit(ast, {\n    visitStringLiteral(path) {\n      if (path.parent.node.type !== 'JSXAttribute') {\n        const raw = path.node.extra?.raw\n        if (raw?.startsWith(\"'\")) single++\n        else if (raw?.startsWith('\"')) double++\n      }\n      return false\n    },\n  })\n\n  if (single >= double) {\n    return \"'\"\n  }\n  return '\"'\n}\n"],"mappings":"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"}

package/dist/esm/transform/types.d.ts

@@ -0,0 +1,31 @@
+import { ImportDeclaration, RouteNode } from '../types.js';
+import { Config } from '../config.js';
+export interface TransformOptions {
+    source: string;
+    ctx: TransformContext;
+    node: RouteNode;
+}
+export type TransformResult = {
+    result: 'no-route-export';
+} | {
+    result: 'not-modified';
+} | {
+    result: 'modified';
+    output: string;
+} | {
+    result: 'error';
+    error?: any;
+};
+export interface TransformImportsConfig {
+    banned?: Array<ImportDeclaration>;
+    required?: Array<ImportDeclaration>;
+}
+export interface TransformContext {
+    target: Config['target'];
+    routeId: string;
+    lazy: boolean;
+    verboseFileRoutes: boolean;
+    preferredQuote?: '"' | "'";
+    /** Set when `target` is `angular`; drives `createFileRoute` import source. */
+    angularRouterPackage?: string;
+}

package/dist/esm/transform/utils.d.ts

@@ -0,0 +1,2 @@
+import { types } from 'recast';
+export declare function ensureStringArgument(callExpression: types.namedTypes.CallExpression, value: string, preferredQuote?: "'" | '"'): boolean;

package/dist/esm/transform/utils.js

@@ -0,0 +1,34 @@
+import { types } from "recast";
+//#region src/transform/utils.ts
+var b = types.builders;
+function ensureStringArgument(callExpression, value, preferredQuote) {
+	const argument = callExpression.arguments[0];
+	if (!argument) {
+		let stringLiteral;
+		if (!preferredQuote) stringLiteral = b.stringLiteral.from({ value });
+		else stringLiteral = b.stringLiteral.from({
+			value,
+			extra: {
+				rawValue: value,
+				raw: `${preferredQuote}${value}${preferredQuote}`
+			}
+		});
+		callExpression.arguments.push(stringLiteral);
+		return true;
+	} else if (argument.type === "StringLiteral") {
+		if (argument.value !== value) {
+			argument.value = value;
+			return true;
+		}
+	} else if (argument.type === "TemplateLiteral") {
+		if (argument.quasis.length === 1 && argument.quasis[0] && argument.quasis[0].value.raw !== value) {
+			argument.quasis[0].value.raw = value;
+			return true;
+		}
+	}
+	return false;
+}
+//#endregion
+export { ensureStringArgument };
+
+//# sourceMappingURL=utils.js.map

package/dist/esm/transform/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../../src/transform/utils.ts"],"sourcesContent":["import { types } from 'recast'\n\nconst b = types.builders\n\nexport function ensureStringArgument(\n  callExpression: types.namedTypes.CallExpression,\n  value: string,\n  preferredQuote?: \"'\" | '\"',\n) {\n  const argument = callExpression.arguments[0]\n  if (!argument) {\n    let stringLiteral: types.namedTypes.StringLiteral\n    if (!preferredQuote) {\n      stringLiteral = b.stringLiteral.from({ value })\n    } else {\n      stringLiteral = b.stringLiteral.from({\n        value,\n        extra: {\n          rawValue: value,\n          raw: `${preferredQuote}${value}${preferredQuote}`,\n        },\n      })\n    }\n    callExpression.arguments.push(stringLiteral)\n    return true\n  } else if (argument.type === 'StringLiteral') {\n    if (argument.value !== value) {\n      argument.value = value\n      return true\n    }\n  } else if (argument.type === 'TemplateLiteral') {\n    if (\n      argument.quasis.length === 1 &&\n      argument.quasis[0] &&\n      argument.quasis[0].value.raw !== value\n    ) {\n      argument.quasis[0].value.raw = value\n      return true\n    }\n  }\n  return false\n}\n"],"mappings":";;AAEA,IAAM,IAAI,MAAM;AAEhB,SAAgB,qBACd,gBACA,OACA,gBACA;CACA,MAAM,WAAW,eAAe,UAAU;AAC1C,KAAI,CAAC,UAAU;EACb,IAAI;AACJ,MAAI,CAAC,eACH,iBAAgB,EAAE,cAAc,KAAK,EAAE,OAAO,CAAC;MAE/C,iBAAgB,EAAE,cAAc,KAAK;GACnC;GACA,OAAO;IACL,UAAU;IACV,KAAK,GAAG,iBAAiB,QAAQ;IAClC;GACF,CAAC;AAEJ,iBAAe,UAAU,KAAK,cAAc;AAC5C,SAAO;YACE,SAAS,SAAS;MACvB,SAAS,UAAU,OAAO;AAC5B,YAAS,QAAQ;AACjB,UAAO;;YAEA,SAAS,SAAS;MAEzB,SAAS,OAAO,WAAW,KAC3B,SAAS,OAAO,MAChB,SAAS,OAAO,GAAG,MAAM,QAAQ,OACjC;AACA,YAAS,OAAO,GAAG,MAAM,MAAM;AAC/B,UAAO;;;AAGX,QAAO"}

package/dist/esm/types.d.ts

@@ -0,0 +1,57 @@
+export type RouteNode = {
+    filePath: string;
+    fullPath: string;
+    variableName: string;
+    _fsRouteType: FsRouteType;
+    routePath?: string;
+    originalRoutePath?: string;
+    cleanedPath?: string;
+    path?: string;
+    isNonPath?: boolean;
+    isVirtualParentRoute?: boolean;
+    isVirtual?: boolean;
+    children?: Array<RouteNode>;
+    parent?: RouteNode;
+    createFileRouteProps?: Set<string>;
+    /**
+     * For virtual routes: the routePath of the explicit parent from virtual config.
+     * Used to prevent auto-nesting siblings based on path prefix matching (#5822, #5431).
+     * Falls back to path-based inference if the explicit parent is not found
+     * (e.g., when the parent is a virtual file-less route that gets filtered out).
+     */
+    _virtualParentRoutePath?: string;
+};
+export interface GetRouteNodesResult {
+    rootRouteNode?: RouteNode;
+    routeNodes: Array<RouteNode>;
+    physicalDirectories: Array<string>;
+}
+export type FsRouteType = '__root' | 'static' | 'layout' | 'pathless_layout' | 'lazy' | 'loader' | 'component' | 'pendingComponent' | 'errorComponent' | 'notFoundComponent';
+export type RouteSubNode = {
+    component?: RouteNode;
+    errorComponent?: RouteNode;
+    notFoundComponent?: RouteNode;
+    pendingComponent?: RouteNode;
+    loader?: RouteNode;
+    lazy?: RouteNode;
+};
+export type ImportSpecifier = {
+    imported: string;
+    local?: string;
+};
+export type ImportDeclaration = {
+    source: string;
+    specifiers: Array<ImportSpecifier>;
+    importKind?: 'type' | 'value';
+};
+export type HandleNodeAccumulator = {
+    routeTree: Array<RouteNode>;
+    routePiecesByPath: Record<string, RouteSubNode>;
+    routeNodes: Array<RouteNode>;
+    /** O(1) lookup by routePath - avoids O(n) .find() on every node */
+    routeNodesByPath: Map<string, RouteNode>;
+};
+export type GetRoutesByFileMapResultValue = {
+    routePath: string;
+};
+export type GetRoutesByFileMapResult = Map<string, GetRoutesByFileMapResultValue>;