@panneau/codemods 0.0.0-stage → 5.0.0-alpha.6

package/dist/run.d.ts

@@ -0,0 +1,23 @@
+import type { Finding } from './context';
+export interface RunOptions {
+    /** Files and folders to rewrite. Folders are read recursively, without `node_modules`. */
+    paths: readonly string[];
+    /** Reports what would change, and writes nothing. */
+    dry?: boolean;
+    /** The folder that paths and findings are relative to. Defaults to the current one. */
+    cwd?: string;
+}
+export interface RunResult {
+    /** Files read, relative to `cwd`. */
+    files: string[];
+    /** Files rewritten (or that would be, with `dry`), relative to `cwd`. */
+    changed: string[];
+    findings: Finding[];
+}
+/** Runs the codemods from Panneau 4 to Panneau 5 on files and folders. */
+export declare function runCodemods({ paths, dry, cwd, }: RunOptions): Promise<RunResult>;
+/** A run as text: the findings by file, then a summary. */
+export declare function formatReport(result: RunResult, { dry }?: {
+    dry?: boolean;
+}): string;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BzC,MAAM,WAAW,UAAU;IACvB,0FAA0F;IAC1F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACtB,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,0EAA0E;AAC1E,wBAAsB,WAAW,CAAC,EAC9B,KAAK,EACL,GAAW,EACX,GAAmB,GACtB,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAqBjC;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,GAAW,EAAE,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CA0B/F"}

package/dist/run.js

@@ -0,0 +1,65 @@
+import { EXTENSIONS, transformSources } from "./transform.js";
+import { readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { extname, join, relative, resolve } from "node:path";
+//#region src/run.ts
+/** Folders the codemods never read. */
+var IGNORED = /* @__PURE__ */ new Set([
+	"node_modules",
+	"vendor",
+	"dist",
+	"build",
+	"public",
+	".git"
+]);
+async function collectFiles(path, files) {
+	if ((await stat(path)).isFile()) {
+		files.push(path);
+		return;
+	}
+	const entries = await readdir(path, { withFileTypes: true });
+	await Promise.all(entries.map(async (entry) => {
+		const child = join(path, entry.name);
+		if (entry.isDirectory()) {
+			if (!IGNORED.has(entry.name) && !entry.name.startsWith(".")) await collectFiles(child, files);
+		} else if (EXTENSIONS.includes(extname(entry.name)) && !entry.name.endsWith(".d.ts")) files.push(child);
+	}));
+}
+/** Runs the codemods from Panneau 4 to Panneau 5 on files and folders. */
+async function runCodemods({ paths, dry = false, cwd = process.cwd() }) {
+	const files = [];
+	for (const path of paths) await collectFiles(resolve(cwd, path), files);
+	const unique = [...new Set(files)].sort();
+	const sources = /* @__PURE__ */ new Map();
+	for (const file of unique) sources.set(file, await readFile(file, "utf8"));
+	const { outputs, findings } = transformSources(sources, cwd);
+	if (!dry) for (const [file, output] of outputs) await writeFile(file, output);
+	return {
+		files: unique.map((file) => relative(cwd, file)),
+		changed: [...outputs.keys()].map((file) => relative(cwd, file)),
+		findings
+	};
+}
+/** A run as text: the findings by file, then a summary. */
+function formatReport(result, { dry = false } = {}) {
+	const lines = [];
+	const byFile = /* @__PURE__ */ new Map();
+	result.findings.forEach((finding) => {
+		byFile.set(finding.file, [...byFile.get(finding.file) ?? [], finding]);
+	});
+	[...byFile.keys()].sort().forEach((file) => {
+		lines.push(file);
+		(byFile.get(file) ?? []).sort((a, b) => (a.line ?? 0) - (b.line ?? 0)).forEach((finding) => {
+			const line = finding.line !== null ? String(finding.line) : "-";
+			lines.push(`  ${line.padStart(4)}  ${finding.rule.padEnd(15)}  ${finding.message}`);
+		});
+		lines.push("");
+	});
+	const changed = result.changed.length;
+	lines.push(`${result.files.length} files read, ${changed} ${dry ? "would change" : "changed"}, ${result.findings.length} findings.`);
+	if (!dry && changed > 0) lines.push("Format the changed files with Prettier: the codemods print what they add their own way. Each finding to fix by hand also has a `// TODO(panneau-5): …` comment in its file. Run the codemods again with --dry to list what is left.");
+	return lines.join("\n");
+}
+//#endregion
+export { formatReport, runCodemods };
+
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","names":[],"sources":["../src/run.ts"],"sourcesContent":["import { readFile, readdir, stat, writeFile } from 'node:fs/promises';\nimport { extname, join, relative, resolve } from 'node:path';\n\nimport type { Finding } from './context';\nimport { EXTENSIONS, transformSources } from './transform';\n\n/** Folders the codemods never read. */\nconst IGNORED = new Set(['node_modules', 'vendor', 'dist', 'build', 'public', '.git']);\n\nasync function collectFiles(path: string, files: string[]): Promise<void> {\n    const stats = await stat(path);\n    if (stats.isFile()) {\n        files.push(path);\n        return;\n    }\n    const entries = await readdir(path, { withFileTypes: true });\n    await Promise.all(\n        entries.map(async (entry) => {\n            const child = join(path, entry.name);\n            if (entry.isDirectory()) {\n                if (!IGNORED.has(entry.name) && !entry.name.startsWith('.')) {\n                    await collectFiles(child, files);\n                }\n            } else if (EXTENSIONS.includes(extname(entry.name)) && !entry.name.endsWith('.d.ts')) {\n                files.push(child);\n            }\n        }),\n    );\n}\n\nexport interface RunOptions {\n    /** Files and folders to rewrite. Folders are read recursively, without `node_modules`. */\n    paths: readonly string[];\n    /** Reports what would change, and writes nothing. */\n    dry?: boolean;\n    /** The folder that paths and findings are relative to. Defaults to the current one. */\n    cwd?: string;\n}\n\nexport interface RunResult {\n    /** Files read, relative to `cwd`. */\n    files: string[];\n    /** Files rewritten (or that would be, with `dry`), relative to `cwd`. */\n    changed: string[];\n    findings: Finding[];\n}\n\n/** Runs the codemods from Panneau 4 to Panneau 5 on files and folders. */\nexport async function runCodemods({\n    paths,\n    dry = false,\n    cwd = process.cwd(),\n}: RunOptions): Promise<RunResult> {\n    const files: string[] = [];\n    for (const path of paths) {\n        await collectFiles(resolve(cwd, path), files);\n    }\n    const unique = [...new Set(files)].sort();\n    const sources = new Map<string, string>();\n    for (const file of unique) {\n        sources.set(file, await readFile(file, 'utf8'));\n    }\n    const { outputs, findings } = transformSources(sources, cwd);\n    if (!dry) {\n        for (const [file, output] of outputs) {\n            await writeFile(file, output);\n        }\n    }\n    return {\n        files: unique.map((file) => relative(cwd, file)),\n        changed: [...outputs.keys()].map((file) => relative(cwd, file)),\n        findings,\n    };\n}\n\n/** A run as text: the findings by file, then a summary. */\nexport function formatReport(result: RunResult, { dry = false }: { dry?: boolean } = {}): string {\n    const lines: string[] = [];\n    const byFile = new Map<string, Finding[]>();\n    result.findings.forEach((finding) => {\n        byFile.set(finding.file, [...(byFile.get(finding.file) ?? []), finding]);\n    });\n    [...byFile.keys()].sort().forEach((file) => {\n        lines.push(file);\n        (byFile.get(file) ?? [])\n            .sort((a, b) => (a.line ?? 0) - (b.line ?? 0))\n            .forEach((finding) => {\n                const line = finding.line !== null ? String(finding.line) : '-';\n                lines.push(`  ${line.padStart(4)}  ${finding.rule.padEnd(15)}  ${finding.message}`);\n            });\n        lines.push('');\n    });\n    const changed = result.changed.length;\n    lines.push(\n        `${result.files.length} files read, ${changed} ${dry ? 'would change' : 'changed'}, ${result.findings.length} findings.`,\n    );\n    if (!dry && changed > 0) {\n        lines.push(\n            'Format the changed files with Prettier: the codemods print what they add their own way. Each finding to fix by hand also has a `// TODO(panneau-5): …` comment in its file. Run the codemods again with --dry to list what is left.',\n        );\n    }\n    return lines.join('\\n');\n}\n"],"mappings":";;;;;AAOA,IAAM,0BAAU,IAAI,IAAI;CAAC;CAAgB;CAAU;CAAQ;CAAS;CAAU;AAAM,CAAC;AAErF,eAAe,aAAa,MAAc,OAAgC;CAEtE,KAAI,MADgB,KAAK,IAAI,EAAA,CACnB,OAAO,GAAG;EAChB,MAAM,KAAK,IAAI;EACf;CACJ;CACA,MAAM,UAAU,MAAM,QAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;CAC3D,MAAM,QAAQ,IACV,QAAQ,IAAI,OAAO,UAAU;EACzB,MAAM,QAAQ,KAAK,MAAM,MAAM,IAAI;EACnC,IAAI,MAAM,YAAY,GACd;OAAA,CAAC,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,GAAG,GACtD,MAAM,aAAa,OAAO,KAAK;EAAA,OAEhC,IAAI,WAAW,SAAS,QAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,OAAO,GAC/E,MAAM,KAAK,KAAK;CAExB,CAAC,CACL;AACJ;;AAoBA,eAAsB,YAAY,EAC9B,OACA,MAAM,OACN,MAAM,QAAQ,IAAI,KACa;CAC/B,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,QAAQ,OACf,MAAM,aAAa,QAAQ,KAAK,IAAI,GAAG,KAAK;CAEhD,MAAM,SAAS,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK;CACxC,MAAM,0BAAU,IAAI,IAAoB;CACxC,KAAK,MAAM,QAAQ,QACf,QAAQ,IAAI,MAAM,MAAM,SAAS,MAAM,MAAM,CAAC;CAElD,MAAM,EAAE,SAAS,aAAa,iBAAiB,SAAS,GAAG;CAC3D,IAAI,CAAC,KACD,KAAK,MAAM,CAAC,MAAM,WAAW,SACzB,MAAM,UAAU,MAAM,MAAM;CAGpC,OAAO;EACH,OAAO,OAAO,KAAK,SAAS,SAAS,KAAK,IAAI,CAAC;EAC/C,SAAS,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,SAAS,KAAK,IAAI,CAAC;EAC9D;CACJ;AACJ;;AAGA,SAAgB,aAAa,QAAmB,EAAE,MAAM,UAA6B,CAAC,GAAW;CAC7F,MAAM,QAAkB,CAAC;CACzB,MAAM,yBAAS,IAAI,IAAuB;CAC1C,OAAO,SAAS,SAAS,YAAY;EACjC,OAAO,IAAI,QAAQ,MAAM,CAAC,GAAI,OAAO,IAAI,QAAQ,IAAI,KAAK,CAAC,GAAI,OAAO,CAAC;CAC3E,CAAC;CACD,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS;EACxC,MAAM,KAAK,IAAI;EACf,CAAC,OAAO,IAAI,IAAI,KAAK,CAAC,EAAA,CACjB,MAAM,GAAG,OAAO,EAAE,QAAQ,MAAM,EAAE,QAAQ,EAAE,CAAC,CAC7C,SAAS,YAAY;GAClB,MAAM,OAAO,QAAQ,SAAS,OAAO,OAAO,QAAQ,IAAI,IAAI;GAC5D,MAAM,KAAK,KAAK,KAAK,SAAS,CAAC,EAAE,IAAI,QAAQ,KAAK,OAAO,EAAE,EAAE,IAAI,QAAQ,SAAS;EACtF,CAAC;EACL,MAAM,KAAK,EAAE;CACjB,CAAC;CACD,MAAM,UAAU,OAAO,QAAQ;CAC/B,MAAM,KACF,GAAG,OAAO,MAAM,OAAO,eAAe,QAAQ,GAAG,MAAM,iBAAiB,UAAU,IAAI,OAAO,SAAS,OAAO,WACjH;CACA,IAAI,CAAC,OAAO,UAAU,GAClB,MAAM,KACF,qOACJ;CAEJ,OAAO,MAAM,KAAK,IAAI;AAC1B"}

package/dist/transform.d.ts

@@ -0,0 +1,28 @@
+import { type FileInfo, type Finding, type Project } from './context';
+/** Extensions of the files the codemods read. */
+export declare const EXTENSIONS: readonly string[];
+/** Reads what the codemods need to know about a file before rewriting the others. */
+export declare function analyze(path: string, source: string): FileInfo;
+/** What the transforms know about the files of a run. */
+export declare function createProject(files: ReadonlyMap<string, FileInfo>): Project;
+export interface TransformResult {
+    /** The new source, or `null` when the file doesn't change. */
+    output: string | null;
+    findings: Finding[];
+}
+/**
+ * Rewrites one file of a run. `file` is the path shown in findings. Parse errors are findings,
+ * and leave the file as it is.
+ */
+export declare function transformFile(path: string, source: string, project: Project, file?: string): TransformResult;
+export interface SourcesResult {
+    /** New sources of the files that change, by path. */
+    outputs: Map<string, string>;
+    findings: Finding[];
+}
+/**
+ * Rewrites a set of files, given by path. Paths of findings are relative to `cwd`. The files are
+ * read together, so that the entry knows the field components and the plugin module.
+ */
+export declare function transformSources(sources: ReadonlyMap<string, string>, cwd?: string): SourcesResult;
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EAKf,MAAM,WAAW,CAAC;AAWnB,iDAAiD;AACjD,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAA2C,CAAC;AAUpF,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAiC9D;AAoBD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,OAAO,CAgC3E;AAED,MAAM,WAAW,eAAe;IAC5B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACvB;AAgCD;;;GAGG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,SAAO,GACZ,eAAe,CAuDjB;AAED,MAAM,WAAW,aAAa;IAC1B,qDAAqD;IACrD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAM,GAAG,aAAa,CAoB/F"}

package/dist/transform.js

@@ -0,0 +1,192 @@
+import { TODO_PREFIX, addTodo, getLine } from "./context.js";
+import { reportBootstrap } from "./transforms/bootstrap.js";
+import { readContainer, transformAppEntry, transformContainer } from "./transforms/entry.js";
+import { findDefaultComponent, getEntryName, transformFieldEntries } from "./transforms/fieldEntries.js";
+import { transformFields } from "./transforms/fields.js";
+import { transformImports } from "./transforms/imports.js";
+import { basename, dirname, extname, join, normalize, relative } from "node:path";
+import jscodeshift from "jscodeshift";
+//#region src/transform.ts
+/** Extensions of the files the codemods read. */
+var EXTENSIONS = [
+	".js",
+	".jsx",
+	".mjs",
+	".ts",
+	".tsx"
+];
+function getParser(path) {
+	return jscodeshift.withParser(extname(path) === ".ts" ? "ts" : "tsx");
+}
+function isTypeScript(path) {
+	return extname(path) === ".ts" || extname(path) === ".tsx";
+}
+/** Reads what the codemods need to know about a file before rewriting the others. */
+function analyze(path, source) {
+	const j = getParser(path);
+	const root = j(source);
+	const defaultReExports = /* @__PURE__ */ new Map();
+	root.find(j.ExportNamedDeclaration).forEach((declaration) => {
+		const module = declaration.node.source?.value;
+		if (typeof module !== "string") return;
+		(declaration.node.specifiers ?? []).forEach((specifier) => {
+			const local = specifier.local?.name;
+			if (specifier.type === "ExportSpecifier" && local !== void 0) {
+				if (local === "default" || local.endsWith("Entry")) defaultReExports.set(String(specifier.exported.name), module);
+			}
+		});
+	});
+	const component = findDefaultComponent(j, root);
+	return {
+		...readContainer(j, root),
+		defaultReExports,
+		importsPanneau: root.find(j.ImportDeclaration).filter((declaration) => String(declaration.node.source.value).startsWith("@panneau/")).size() > 0,
+		hasDefaultExport: root.find(j.ExportDefaultDeclaration).size() > 0,
+		fieldEntry: component !== null ? getEntryName(component.name) : null
+	};
+}
+/** Resolves a relative module against the files of the run, as bundlers do. */
+function resolveModule(files, from, specifier) {
+	if (!specifier.startsWith(".")) return null;
+	const base = normalize(join(dirname(from), specifier));
+	return [
+		base,
+		...EXTENSIONS.map((extension) => `${base}${extension}`),
+		...EXTENSIONS.map((extension) => join(base, `index${extension}`))
+	].find((candidate) => files.has(candidate)) ?? null;
+}
+/** What the transforms know about the files of a run. */
+function createProject(files) {
+	const resolve = (from, specifier) => resolveModule(files, from, specifier);
+	const fieldFiles = /* @__PURE__ */ new Set();
+	let hasFieldsModule = false;
+	files.forEach((info, path) => {
+		const module = info.namespaces.get("fields");
+		const index = module !== void 0 ? resolve(path, module) : null;
+		if (index === null) return;
+		hasFieldsModule = true;
+		files.get(index)?.defaultReExports.forEach((specifier) => {
+			const file = resolve(index, specifier);
+			if (file !== null) fieldFiles.add(file);
+		});
+	});
+	return {
+		resolve,
+		info: (path) => files.get(path) ?? null,
+		isField: (path) => hasFieldsModule ? fieldFiles.has(path) : basename(dirname(path)) === "fields" && files.get(path)?.hasDefaultExport === true && files.get(path)?.importsPanneau === true,
+		pluginModules: () => [...files.entries()].filter(([, info]) => info.isContainer).map(([path]) => path)
+	};
+}
+/**
+* Entries are inserted right after their component: they get a blank line before them, and
+* before the comments over them.
+*/
+function spaceEntries(source) {
+	const lines = source.split("\n");
+	for (let index = lines.length - 1; index > 0; index -= 1) if ((lines[index] ?? "").startsWith("/** The registry entry of ")) {
+		let top = index;
+		while (top > 0 && (lines[top - 1] ?? "").startsWith(`// TODO(panneau-5):`)) top -= 1;
+		if (top > 0 && (lines[top - 1] ?? "").trim() !== "") lines.splice(top, 0, "");
+	}
+	return lines.join("\n");
+}
+/** `// TODO(panneau-5): …` comments of a source, with their lines. */
+function readTodos(source) {
+	return source.split("\n").flatMap((text, index) => {
+		const position = text.indexOf(TODO_PREFIX);
+		return position === -1 ? [] : [{
+			line: index + 1,
+			message: text.slice(position + TODO_PREFIX.length).trim()
+		}];
+	});
+}
+/**
+* Rewrites one file of a run. `file` is the path shown in findings. Parse errors are findings,
+* and leave the file as it is.
+*/
+function transformFile(path, source, project, file = path) {
+	const findings = [];
+	const j = getParser(path);
+	let root;
+	try {
+		root = j(source);
+	} catch (error) {
+		return {
+			output: null,
+			findings: [{
+				file,
+				line: null,
+				rule: "parse",
+				message: `can't be parsed: ${error instanceof Error ? error.message : String(error)}`
+			}]
+		};
+	}
+	const api = {
+		j,
+		root,
+		path,
+		typescript: isTypeScript(path),
+		project,
+		report(node, rule, message, options = {}) {
+			findings.push({
+				file,
+				line: getLine(node),
+				rule,
+				message
+			});
+			if (options.todo === true && node !== null) addTodo(j, node, message);
+		}
+	};
+	const plugin = transformContainer(api);
+	let output;
+	if (plugin !== null) output = plugin;
+	else {
+		transformAppEntry(api);
+		transformFields(api);
+		transformFieldEntries(api);
+		transformImports(api);
+		reportBootstrap(api);
+		output = spaceEntries(root.toSource({ quote: "single" }));
+	}
+	const reported = new Set(findings.map((finding) => finding.message));
+	readTodos(output).forEach(({ line, message }) => {
+		if (!reported.has(message)) findings.push({
+			file,
+			line,
+			rule: "todo",
+			message
+		});
+	});
+	return {
+		output: output.replace(/\s+/g, "") !== source.replace(/\s+/g, "") ? output : null,
+		findings
+	};
+}
+/**
+* Rewrites a set of files, given by path. Paths of findings are relative to `cwd`. The files are
+* read together, so that the entry knows the field components and the plugin module.
+*/
+function transformSources(sources, cwd = "/") {
+	const infos = /* @__PURE__ */ new Map();
+	const findings = [];
+	sources.forEach((source, path) => {
+		try {
+			infos.set(path, analyze(path, source));
+		} catch {}
+	});
+	const project = createProject(infos);
+	const outputs = /* @__PURE__ */ new Map();
+	sources.forEach((source, path) => {
+		const result = transformFile(path, source, project, relative(cwd, path) || path);
+		if (result.output !== null) outputs.set(path, result.output);
+		findings.push(...result.findings);
+	});
+	return {
+		outputs,
+		findings
+	};
+}
+//#endregion
+export { EXTENSIONS, analyze, createProject, transformFile, transformSources };
+
+//# sourceMappingURL=transform.js.map

package/dist/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","names":[],"sources":["../src/transform.ts"],"sourcesContent":["import jscodeshift, { type ASTPath, type Collection, type JSCodeshift } from 'jscodeshift';\nimport { basename, dirname, extname, join, normalize, relative } from 'node:path';\n\nimport {\n    type FileInfo,\n    type Finding,\n    type Project,\n    TODO_PREFIX,\n    type TransformApi,\n    addTodo,\n    getLine,\n} from './context';\nimport { reportBootstrap } from './transforms/bootstrap';\nimport { readContainer, transformAppEntry, transformContainer } from './transforms/entry';\nimport {\n    findDefaultComponent,\n    getEntryName,\n    transformFieldEntries,\n} from './transforms/fieldEntries';\nimport { transformFields } from './transforms/fields';\nimport { transformImports } from './transforms/imports';\n\n/** Extensions of the files the codemods read. */\nexport const EXTENSIONS: readonly string[] = ['.js', '.jsx', '.mjs', '.ts', '.tsx'];\n\nfunction getParser(path: string): JSCodeshift {\n    return jscodeshift.withParser(extname(path) === '.ts' ? 'ts' : 'tsx');\n}\n\nfunction isTypeScript(path: string): boolean {\n    return extname(path) === '.ts' || extname(path) === '.tsx';\n}\n\n/** Reads what the codemods need to know about a file before rewriting the others. */\nexport function analyze(path: string, source: string): FileInfo {\n    const j = getParser(path);\n    const root = j(source);\n    const defaultReExports = new Map<string, string>();\n    root.find(j.ExportNamedDeclaration).forEach((declaration) => {\n        const module = declaration.node.source?.value;\n        if (typeof module !== 'string') {\n            return;\n        }\n        (declaration.node.specifiers ?? []).forEach((specifier) => {\n            const local = (specifier as { local?: { name: string } | null }).local?.name;\n            if (specifier.type === 'ExportSpecifier' && local !== undefined) {\n                // A file already rewritten re-exports the entry (`AgencyEntry as Agency`).\n                if (local === 'default' || local.endsWith('Entry')) {\n                    defaultReExports.set(String(specifier.exported.name), module);\n                }\n            }\n        });\n    });\n    const component = findDefaultComponent(j, root);\n    return {\n        ...readContainer(j, root),\n        defaultReExports,\n        importsPanneau:\n            root\n                .find(j.ImportDeclaration)\n                .filter((declaration) =>\n                    String(declaration.node.source.value).startsWith('@panneau/'),\n                )\n                .size() > 0,\n        hasDefaultExport: root.find(j.ExportDefaultDeclaration).size() > 0,\n        fieldEntry: component !== null ? getEntryName(component.name) : null,\n    };\n}\n\n/** Resolves a relative module against the files of the run, as bundlers do. */\nfunction resolveModule(\n    files: ReadonlyMap<string, FileInfo>,\n    from: string,\n    specifier: string,\n): string | null {\n    if (!specifier.startsWith('.')) {\n        return null;\n    }\n    const base = normalize(join(dirname(from), specifier));\n    const candidates = [\n        base,\n        ...EXTENSIONS.map((extension) => `${base}${extension}`),\n        ...EXTENSIONS.map((extension) => join(base, `index${extension}`)),\n    ];\n    return candidates.find((candidate) => files.has(candidate)) ?? null;\n}\n\n/** What the transforms know about the files of a run. */\nexport function createProject(files: ReadonlyMap<string, FileInfo>): Project {\n    const resolve = (from: string, specifier: string) => resolveModule(files, from, specifier);\n    const fieldFiles = new Set<string>();\n    let hasFieldsModule = false;\n    files.forEach((info, path) => {\n        const module = info.namespaces.get('fields');\n        const index = module !== undefined ? resolve(path, module) : null;\n        if (index === null) {\n            return;\n        }\n        hasFieldsModule = true;\n        files.get(index)?.defaultReExports.forEach((specifier) => {\n            const file = resolve(index, specifier);\n            if (file !== null) {\n                fieldFiles.add(file);\n            }\n        });\n    });\n    return {\n        resolve,\n        info: (path) => files.get(path) ?? null,\n        // Without the container of the app (or the plugin module made from it) in the run, the\n        // components of a `fields` folder that import Panneau are fields.\n        isField: (path) =>\n            hasFieldsModule\n                ? fieldFiles.has(path)\n                : basename(dirname(path)) === 'fields' &&\n                  files.get(path)?.hasDefaultExport === true &&\n                  files.get(path)?.importsPanneau === true,\n        pluginModules: () =>\n            [...files.entries()].filter(([, info]) => info.isContainer).map(([path]) => path),\n    };\n}\n\nexport interface TransformResult {\n    /** The new source, or `null` when the file doesn't change. */\n    output: string | null;\n    findings: Finding[];\n}\n\n/**\n * Entries are inserted right after their component: they get a blank line before them, and\n * before the comments over them.\n */\nfunction spaceEntries(source: string): string {\n    const lines = source.split('\\n');\n    for (let index = lines.length - 1; index > 0; index -= 1) {\n        if ((lines[index] ?? '').startsWith('/** The registry entry of ')) {\n            let top = index;\n            while (top > 0 && (lines[top - 1] ?? '').startsWith(`// ${TODO_PREFIX}`)) {\n                top -= 1;\n            }\n            if (top > 0 && (lines[top - 1] ?? '').trim() !== '') {\n                lines.splice(top, 0, '');\n            }\n        }\n    }\n    return lines.join('\\n');\n}\n\n/** `// TODO(panneau-5): …` comments of a source, with their lines. */\nfunction readTodos(source: string): { line: number; message: string }[] {\n    return source.split('\\n').flatMap((text, index) => {\n        const position = text.indexOf(TODO_PREFIX);\n        return position === -1\n            ? []\n            : [{ line: index + 1, message: text.slice(position + TODO_PREFIX.length).trim() }];\n    });\n}\n\n/**\n * Rewrites one file of a run. `file` is the path shown in findings. Parse errors are findings,\n * and leave the file as it is.\n */\nexport function transformFile(\n    path: string,\n    source: string,\n    project: Project,\n    file = path,\n): TransformResult {\n    const findings: Finding[] = [];\n    const j = getParser(path);\n    let root: Collection;\n    try {\n        root = j(source);\n    } catch (error) {\n        return {\n            output: null,\n            findings: [\n                {\n                    file,\n                    line: null,\n                    rule: 'parse',\n                    message: `can't be parsed: ${error instanceof Error ? error.message : String(error)}`,\n                },\n            ],\n        };\n    }\n    const api: TransformApi = {\n        j,\n        root,\n        path,\n        typescript: isTypeScript(path),\n        project,\n        report(node: ASTPath | null, rule: string, message: string, options = {}) {\n            findings.push({ file, line: getLine(node), rule, message });\n            if (options.todo === true && node !== null) {\n                addTodo(j, node, message);\n            }\n        },\n    };\n    const plugin = transformContainer(api);\n    let output: string;\n    if (plugin !== null) {\n        output = plugin;\n    } else {\n        transformAppEntry(api);\n        transformFields(api);\n        transformFieldEntries(api);\n        transformImports(api);\n        reportBootstrap(api);\n        output = spaceEntries(root.toSource({ quote: 'single' }));\n    }\n    // Comments left by an earlier run, or written into a plugin module, are findings too.\n    const reported = new Set(findings.map((finding) => finding.message));\n    readTodos(output).forEach(({ line, message }) => {\n        if (!reported.has(message)) {\n            findings.push({ file, line, rule: 'todo', message });\n        }\n    });\n    // Recast reprints some untouched expressions once the tree is traversed (a multi-line\n    // condition in parentheses). Such a file has no change of its own: it stays as it is.\n    const changed = output.replace(/\\s+/g, '') !== source.replace(/\\s+/g, '');\n    return { output: changed ? output : null, findings };\n}\n\nexport interface SourcesResult {\n    /** New sources of the files that change, by path. */\n    outputs: Map<string, string>;\n    findings: Finding[];\n}\n\n/**\n * Rewrites a set of files, given by path. Paths of findings are relative to `cwd`. The files are\n * read together, so that the entry knows the field components and the plugin module.\n */\nexport function transformSources(sources: ReadonlyMap<string, string>, cwd = '/'): SourcesResult {\n    const infos = new Map<string, FileInfo>();\n    const findings: Finding[] = [];\n    sources.forEach((source, path) => {\n        try {\n            infos.set(path, analyze(path, source));\n        } catch {\n            // `transformFile` reports the parse error.\n        }\n    });\n    const project = createProject(infos);\n    const outputs = new Map<string, string>();\n    sources.forEach((source, path) => {\n        const result = transformFile(path, source, project, relative(cwd, path) || path);\n        if (result.output !== null) {\n            outputs.set(path, result.output);\n        }\n        findings.push(...result.findings);\n    });\n    return { outputs, findings };\n}\n"],"mappings":"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"}

package/dist/transforms/bootstrap.d.ts

@@ -0,0 +1,6 @@
+import type { TransformApi } from '../context';
+/** Whether a class is one of Bootstrap 5 (and 4's `ml-*`, `sr-only`), or of Bootstrap Icons. */
+export declare function isBootstrapClass(name: string): boolean;
+/** Reports the Bootstrap classes of each `className` (or `*ClassName`) prop, with a TODO. */
+export declare function reportBootstrap(api: TransformApi): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/transforms/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/transforms/bootstrap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiC/C,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AA6BD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAyBvD"}

package/dist/transforms/bootstrap.js

@@ -0,0 +1,65 @@
+//#region src/transforms/bootstrap.ts
+/** Prefixes of Bootstrap classes, which always have a suffix: `mb-3`, `btn-primary`. */
+var PREFIXED = /^(d|m[tbsexylr]?|p[tbsexylr]?|g[xy]?|gap|row-cols|col|offset|order|flex|justify-content|align-(items|self|content)|text|fw|fs|fst|lh|bg|border|rounded|shadow|w|h|mw|mh|vw|vh|position|top|bottom|start|end|float|overflow|opacity|z|ratio|display|btn|card|badge|alert|list-group|nav|navbar|dropdown|modal|table|form|input-group|spinner|progress|pagination|breadcrumb|container|bi)-[a-z0-9-]+$/;
+/** Bootstrap classes without a suffix. */
+var STANDALONE = /* @__PURE__ */ new Set([
+	"row",
+	"col",
+	"container",
+	"btn",
+	"close",
+	"card",
+	"badge",
+	"alert",
+	"nav",
+	"navbar",
+	"dropdown",
+	"modal",
+	"table",
+	"small",
+	"lead",
+	"visible",
+	"invisible",
+	"visually-hidden",
+	"sr-only",
+	"border",
+	"rounded",
+	"shadow",
+	"bi"
+]);
+/** Whether a class is one of Bootstrap 5 (and 4's `ml-*`, `sr-only`), or of Bootstrap Icons. */
+function isBootstrapClass(name) {
+	return STANDALONE.has(name) || PREFIXED.test(name);
+}
+/** The literal strings of an expression: class names and `classNames({ 'mb-3': … })` keys. */
+function collectStrings(node, strings) {
+	if (node === null || typeof node !== "object") return;
+	const value = node;
+	if ((value.type === "StringLiteral" || value.type === "Literal") && typeof value.value === "string") {
+		strings.push(value.value);
+		return;
+	}
+	if (value.type === "TemplateLiteral") (value.quasis ?? []).forEach((quasi) => strings.push(quasi.value.raw));
+	Object.entries(node).forEach(([key, child]) => {
+		if (key !== "loc" && key !== "comments" && key !== "tokens") {
+			if (Array.isArray(child)) child.forEach((item) => collectStrings(item, strings));
+			else if (typeof child === "object" && child !== null && key !== "type") collectStrings(child, strings);
+		}
+	});
+}
+/** Reports the Bootstrap classes of each `className` (or `*ClassName`) prop, with a TODO. */
+function reportBootstrap(api) {
+	const { j, root } = api;
+	root.find(j.JSXAttribute).forEach((path) => {
+		const { name } = path.node;
+		if (name.type !== "JSXIdentifier" || !/^className$|ClassName$/.test(name.name)) return;
+		const strings = [];
+		collectStrings(path.node.value, strings);
+		const classes = [...new Set(strings.flatMap((string) => string.split(/\s+/)).filter((value) => value !== "" && isBootstrapClass(value)))];
+		if (classes.length > 0) api.report(path, "bootstrap", `Bootstrap ${classes.length > 1 ? "classes" : "class"} ${classes.map((value) => `\`${value}\``).join(", ")} in \`${name.name}\`: Panneau 5 has no Bootstrap (\`@panneau/ui\` primitives, CSS Modules, or the Bootstrap-compatible theme)`, { todo: true });
+	});
+}
+//#endregion
+export { isBootstrapClass, reportBootstrap };
+
+//# sourceMappingURL=bootstrap.js.map

package/dist/transforms/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","names":[],"sources":["../../src/transforms/bootstrap.ts"],"sourcesContent":["// Panneau 5 has no Bootstrap: components style themselves with CSS Modules and design tokens.\n// The Bootstrap classes of custom components are reported, not rewritten: they are replaced with\n// `@panneau/ui` primitives, or styled by the Bootstrap-compatible theme.\nimport type { ASTPath, JSXAttribute } from 'jscodeshift';\n\nimport type { TransformApi } from '../context';\n\n/** Prefixes of Bootstrap classes, which always have a suffix: `mb-3`, `btn-primary`. */\nconst PREFIXED =\n    /^(d|m[tbsexylr]?|p[tbsexylr]?|g[xy]?|gap|row-cols|col|offset|order|flex|justify-content|align-(items|self|content)|text|fw|fs|fst|lh|bg|border|rounded|shadow|w|h|mw|mh|vw|vh|position|top|bottom|start|end|float|overflow|opacity|z|ratio|display|btn|card|badge|alert|list-group|nav|navbar|dropdown|modal|table|form|input-group|spinner|progress|pagination|breadcrumb|container|bi)-[a-z0-9-]+$/;\n\n/** Bootstrap classes without a suffix. */\nconst STANDALONE = new Set([\n    'row',\n    'col',\n    'container',\n    'btn',\n    'close',\n    'card',\n    'badge',\n    'alert',\n    'nav',\n    'navbar',\n    'dropdown',\n    'modal',\n    'table',\n    'small',\n    'lead',\n    'visible',\n    'invisible',\n    'visually-hidden',\n    'sr-only',\n    'border',\n    'rounded',\n    'shadow',\n    'bi',\n]);\n\n/** Whether a class is one of Bootstrap 5 (and 4's `ml-*`, `sr-only`), or of Bootstrap Icons. */\nexport function isBootstrapClass(name: string): boolean {\n    return STANDALONE.has(name) || PREFIXED.test(name);\n}\n\n/** The literal strings of an expression: class names and `classNames({ 'mb-3': … })` keys. */\nfunction collectStrings(node: unknown, strings: string[]): void {\n    if (node === null || typeof node !== 'object') {\n        return;\n    }\n    const value = node as { type?: string; value?: unknown; quasis?: { value: { raw: string } }[] };\n    if (\n        (value.type === 'StringLiteral' || value.type === 'Literal') &&\n        typeof value.value === 'string'\n    ) {\n        strings.push(value.value);\n        return;\n    }\n    if (value.type === 'TemplateLiteral') {\n        (value.quasis ?? []).forEach((quasi) => strings.push(quasi.value.raw));\n    }\n    Object.entries(node).forEach(([key, child]) => {\n        if (key !== 'loc' && key !== 'comments' && key !== 'tokens') {\n            if (Array.isArray(child)) {\n                child.forEach((item) => collectStrings(item, strings));\n            } else if (typeof child === 'object' && child !== null && key !== 'type') {\n                collectStrings(child, strings);\n            }\n        }\n    });\n}\n\n/** Reports the Bootstrap classes of each `className` (or `*ClassName`) prop, with a TODO. */\nexport function reportBootstrap(api: TransformApi): void {\n    const { j, root } = api;\n    root.find(j.JSXAttribute).forEach((path: ASTPath<JSXAttribute>) => {\n        const { name } = path.node;\n        if (name.type !== 'JSXIdentifier' || !/^className$|ClassName$/.test(name.name)) {\n            return;\n        }\n        const strings: string[] = [];\n        collectStrings(path.node.value, strings);\n        const classes = [\n            ...new Set(\n                strings\n                    .flatMap((string) => string.split(/\\s+/))\n                    .filter((value) => value !== '' && isBootstrapClass(value)),\n            ),\n        ];\n        if (classes.length > 0) {\n            api.report(\n                path,\n                'bootstrap',\n                `Bootstrap ${classes.length > 1 ? 'classes' : 'class'} ${classes.map((value) => `\\`${value}\\``).join(', ')} in \\`${name.name}\\`: Panneau 5 has no Bootstrap (\\`@panneau/ui\\` primitives, CSS Modules, or the Bootstrap-compatible theme)`,\n                { todo: true },\n            );\n        }\n    });\n}\n"],"mappings":";;AAQA,IAAM,WACF;;AAGJ,IAAM,6BAAa,IAAI,IAAI;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC;;AAGD,SAAgB,iBAAiB,MAAuB;CACpD,OAAO,WAAW,IAAI,IAAI,KAAK,SAAS,KAAK,IAAI;AACrD;;AAGA,SAAS,eAAe,MAAe,SAAyB;CAC5D,IAAI,SAAS,QAAQ,OAAO,SAAS,UACjC;CAEJ,MAAM,QAAQ;CACd,KACK,MAAM,SAAS,mBAAmB,MAAM,SAAS,cAClD,OAAO,MAAM,UAAU,UACzB;EACE,QAAQ,KAAK,MAAM,KAAK;EACxB;CACJ;CACA,IAAI,MAAM,SAAS,mBACf,CAAC,MAAM,UAAU,CAAC,EAAA,CAAG,SAAS,UAAU,QAAQ,KAAK,MAAM,MAAM,GAAG,CAAC;CAEzE,OAAO,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EAC3C,IAAI,QAAQ,SAAS,QAAQ,cAAc,QAAQ,UAAU;GACzD,IAAI,MAAM,QAAQ,KAAK,GACnB,MAAM,SAAS,SAAS,eAAe,MAAM,OAAO,CAAC;QAClD,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,QAAQ,QAC9D,eAAe,OAAO,OAAO;EAErC;CACJ,CAAC;AACL;;AAGA,SAAgB,gBAAgB,KAAyB;CACrD,MAAM,EAAE,GAAG,SAAS;CACpB,KAAK,KAAK,EAAE,YAAY,CAAC,CAAC,SAAS,SAAgC;EAC/D,MAAM,EAAE,SAAS,KAAK;EACtB,IAAI,KAAK,SAAS,mBAAmB,CAAC,yBAAyB,KAAK,KAAK,IAAI,GACzE;EAEJ,MAAM,UAAoB,CAAC;EAC3B,eAAe,KAAK,KAAK,OAAO,OAAO;EACvC,MAAM,UAAU,CACZ,GAAG,IAAI,IACH,QACK,SAAS,WAAW,OAAO,MAAM,KAAK,CAAC,CAAC,CACxC,QAAQ,UAAU,UAAU,MAAM,iBAAiB,KAAK,CAAC,CAClE,CACJ;EACA,IAAI,QAAQ,SAAS,GACjB,IAAI,OACA,MACA,aACA,aAAa,QAAQ,SAAS,IAAI,YAAY,QAAQ,GAAG,QAAQ,KAAK,UAAU,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,QAAQ,KAAK,KAAK,8GAC7H,EAAE,MAAM,KAAK,CACjB;CAER,CAAC;AACL"}

package/dist/transforms/entry.d.ts

@@ -0,0 +1,15 @@
+import type { Collection, JSCodeshift } from 'jscodeshift';
+import { type FileInfo, type TransformApi } from '../context';
+/** What `analyze` reads about the entry of a file. */
+export declare function readContainer(j: JSCodeshift, root: Collection): Pick<FileInfo, 'isContainer' | 'namespaces'>;
+/**
+ * Rewrites a v4 container as a plugin module. Returns the new source, or `null` when the file
+ * isn't a container.
+ */
+export declare function transformContainer(api: TransformApi): string | null;
+/**
+ * Adds the plugins made from containers to the `plugins` of `createPanneauApp()` in the entry of
+ * Panneau 5, when it is one of the files.
+ */
+export declare function transformAppEntry(api: TransformApi): void;
+//# sourceMappingURL=entry.d.ts.map

package/dist/transforms/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/transforms/entry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAER,UAAU,EAEV,WAAW,EAId,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,QAAQ,EAAe,KAAK,YAAY,EAAgB,MAAM,YAAY,CAAC;AAkJzF,sDAAsD;AACtD,wBAAgB,aAAa,CACzB,CAAC,EAAE,WAAW,EACd,IAAI,EAAE,UAAU,GACjB,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAAC,CAiB9C;AAyKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAiBnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAuEzD"}