eaa-kit 0.2.1 → 0.4.0

package/dist/frameworks-B4ClIJgE.js

@@ -0,0 +1,314 @@
+import { t as exists } from "./fs-BmPtmFke.js";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+//#region src/audit/frameworks.ts
+/**
+* Most specific first. Several of these depend on Vite, so Vite is last: a
+* SvelteKit project is a SvelteKit project, not a Vite one.
+*
+* Several carry `files` as well as `packages` even though they are npm
+* packages. A config file named after the framework is as good an identifier as
+* the dependency, and it still works where package.json is missing, unreadable,
+* or belongs to a workspace root rather than the project in front of us.
+*/
+const FRAMEWORKS = [
+	{
+		id: "next",
+		name: "Next.js",
+		packages: ["next"],
+		files: [
+			"next.config.js",
+			"next.config.mjs",
+			"next.config.ts"
+		],
+		outputs: ["out"],
+		configs: [
+			"next.config.js",
+			"next.config.mjs",
+			"next.config.ts"
+		],
+		outputPattern: /distDir\s*:\s*['"`]([^'"`]+)['"`]/,
+		staticOutput: {
+			needs: "output: 'export'",
+			how: "add output: 'export' to your Next config, then build"
+		},
+		serves: true
+	},
+	{
+		id: "nuxt",
+		name: "Nuxt",
+		packages: ["nuxt"],
+		files: ["nuxt.config.ts", "nuxt.config.js"],
+		outputs: [".output/public", "dist"],
+		staticOutput: {
+			needs: "nuxt generate",
+			how: "run nuxt generate rather than nuxt build"
+		},
+		serves: true
+	},
+	{
+		id: "sveltekit",
+		name: "SvelteKit",
+		packages: ["@sveltejs/kit"],
+		files: ["svelte.config.js"],
+		outputs: ["build", ".svelte-kit/output/prerendered/pages"],
+		staticOutput: {
+			needs: "@sveltejs/adapter-static",
+			how: "use @sveltejs/adapter-static, then build"
+		},
+		serves: true
+	},
+	{
+		id: "remix",
+		name: "React Router / Remix",
+		packages: [
+			"@remix-run/react",
+			"react-router",
+			"@react-router/dev"
+		],
+		outputs: ["build/client"],
+		serves: true
+	},
+	{
+		id: "astro",
+		name: "Astro",
+		packages: ["astro"],
+		files: [
+			"astro.config.mjs",
+			"astro.config.js",
+			"astro.config.ts"
+		],
+		outputs: ["dist"],
+		configs: [
+			"astro.config.mjs",
+			"astro.config.js",
+			"astro.config.ts"
+		],
+		outputPattern: /outDir\s*:\s*['"`]([^'"`]+)['"`]/,
+		serves: true
+	},
+	{
+		id: "gatsby",
+		name: "Gatsby",
+		packages: ["gatsby"],
+		outputs: ["public"],
+		serves: false
+	},
+	{
+		id: "docusaurus",
+		name: "Docusaurus",
+		packages: ["@docusaurus/core"],
+		outputs: ["build"],
+		serves: false
+	},
+	{
+		id: "vitepress",
+		name: "VitePress",
+		packages: ["vitepress"],
+		files: [".vitepress/config.ts", "docs/.vitepress/config.ts"],
+		outputs: [".vitepress/dist", "docs/.vitepress/dist"],
+		serves: false
+	},
+	{
+		id: "eleventy",
+		name: "Eleventy",
+		packages: ["@11ty/eleventy"],
+		outputs: ["_site"],
+		configs: [
+			".eleventy.js",
+			"eleventy.config.js",
+			"eleventy.config.mjs"
+		],
+		outputPattern: /output\s*:\s*['"`]([^'"`]+)['"`]/,
+		serves: false
+	},
+	{
+		id: "angular",
+		name: "Angular",
+		packages: ["@angular/core"],
+		outputs: ["dist"],
+		serves: false
+	},
+	{
+		id: "cra",
+		name: "Create React App",
+		packages: ["react-scripts"],
+		outputs: ["build"],
+		serves: false
+	},
+	{
+		id: "hugo",
+		name: "Hugo",
+		packages: [],
+		files: [
+			"hugo.toml",
+			"hugo.yaml",
+			"config.toml"
+		],
+		outputs: ["public"],
+		serves: false
+	},
+	{
+		id: "jekyll",
+		name: "Jekyll",
+		packages: [],
+		files: ["_config.yml"],
+		outputs: ["_site"],
+		serves: false
+	},
+	{
+		id: "wordpress",
+		name: "WordPress",
+		packages: [],
+		files: [
+			"wp-config.php",
+			"wp-config-sample.php",
+			"wp-load.php"
+		],
+		outputs: [],
+		serves: true,
+		serveCommand: "wp-env start, ddev start, or whichever local stack this site uses"
+	},
+	{
+		id: "typo3",
+		name: "TYPO3",
+		packages: [],
+		files: [
+			"typo3conf",
+			"public/typo3conf",
+			"typo3"
+		],
+		outputs: [],
+		serves: true,
+		serveCommand: "ddev start, or your usual local stack"
+	},
+	{
+		id: "craft",
+		name: "Craft CMS",
+		packages: [],
+		files: ["craft"],
+		outputs: [],
+		serves: true,
+		serveCommand: "ddev start, or php craft serve"
+	},
+	{
+		id: "laravel",
+		name: "Laravel",
+		packages: [],
+		files: ["artisan"],
+		outputs: [],
+		serves: true,
+		serveCommand: "php artisan serve"
+	},
+	{
+		id: "symfony",
+		name: "Symfony",
+		packages: [],
+		files: ["bin/console", "symfony.lock"],
+		outputs: [],
+		serves: true,
+		serveCommand: "symfony serve, or php -S localhost:8000 -t public"
+	},
+	{
+		id: "rails",
+		name: "Ruby on Rails",
+		packages: [],
+		files: ["bin/rails", "config.ru"],
+		outputs: [],
+		serves: true,
+		serveCommand: "bin/rails server"
+	},
+	{
+		id: "django",
+		name: "Django",
+		packages: [],
+		files: ["manage.py"],
+		outputs: [],
+		serves: true,
+		serveCommand: "python manage.py runserver"
+	},
+	{
+		id: "vite",
+		name: "Vite",
+		packages: ["vite"],
+		outputs: ["dist"],
+		configs: [
+			"vite.config.ts",
+			"vite.config.js",
+			"vite.config.mjs"
+		],
+		outputPattern: /outDir\s*:\s*['"`]([^'"`]+)['"`]/,
+		serves: true
+	}
+];
+/** Output directories to try when nothing was recognised. */
+const FALLBACK_OUTPUTS = [
+	"dist",
+	"out",
+	"build",
+	"_site",
+	"public",
+	".output/public"
+];
+/**
+* The framework this project uses, if it is one this knows.
+*
+* Dependencies decide it where there are any, because a package.json states
+* what a project is far more reliably than a file lying in the root. The
+* file-based entries exist for Hugo and Jekyll, which have no package.json to
+* read.
+*/
+async function detectFramework(cwd, pkg) {
+	const deps = {
+		...pkg?.dependencies,
+		...pkg?.devDependencies
+	};
+	for (const framework of FRAMEWORKS) {
+		const byPackage = framework.packages.some((name) => deps[name] !== void 0);
+		let byFile = false;
+		if (!byPackage && framework.files !== void 0) {
+			for (const file of framework.files) if (await exists(file, cwd)) {
+				byFile = true;
+				break;
+			}
+		}
+		if (!byPackage && !byFile) continue;
+		const configured = await outputFromConfig(cwd, framework);
+		const outputs = configured === void 0 ? [...framework.outputs] : [configured, ...framework.outputs];
+		return {
+			framework,
+			outputs: [...new Set(outputs)]
+		};
+	}
+}
+/**
+* A custom output directory, read out of the framework's config file.
+*
+* Read with a pattern rather than executed. A config file is code, and this runs
+* before anything has decided the project is worth trusting; a regex that
+* misses a computed value is a directory not found, which the caller already
+* handles, while running the file to find out is a different class of risk
+* entirely.
+*/
+async function outputFromConfig(cwd, framework) {
+	if (framework.configs === void 0 || framework.outputPattern === void 0) return void 0;
+	for (const name of framework.configs) {
+		let source;
+		try {
+			source = await readFile(path.resolve(cwd, name), "utf8");
+		} catch {
+			continue;
+		}
+		const value = framework.outputPattern.exec(source)?.[1];
+		if (value === void 0 || value === "") continue;
+		if (path.isAbsolute(value)) continue;
+		return value.replace(/^\.\//, "");
+	}
+}
+/** Every output directory worth trying, framework-aware, most likely first. */
+async function candidateOutputs(cwd, pkg) {
+	const detected = await detectFramework(cwd, pkg);
+	return [.../* @__PURE__ */ new Set([...detected?.outputs ?? [], ...FALLBACK_OUTPUTS])];
+}
+//#endregion
+export { outputFromConfig as a, detectFramework as i, FRAMEWORKS as n, candidateOutputs as r, FALLBACK_OUTPUTS as t };

package/dist/frameworks-etFg_O8K.js

@@ -0,0 +1,2 @@
+import { i as detectFramework, t as FALLBACK_OUTPUTS } from "./frameworks-B4ClIJgE.js";
+export { FALLBACK_OUTPUTS, detectFramework };

package/dist/fs-BmPtmFke.js

@@ -0,0 +1,40 @@
+import { stat } from "node:fs/promises";
+import path from "node:path";
+//#region src/fs.ts
+/**
+* Asking the filesystem a yes-or-no question.
+*
+* Six modules had their own copy of the same try/stat/catch, each answering a
+* slightly different question and each getting it right by hand. A path that
+* cannot be stat'd is not a path of the kind asked about, which is the only
+* behaviour any caller here wants from an unreadable directory.
+*/
+/** Whether anything is there, resolved against `root` when one is given. */
+async function exists(target, root) {
+	try {
+		await stat(root === void 0 ? target : path.resolve(root, target));
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function isFile(target) {
+	try {
+		return (await stat(target)).isFile();
+	} catch {
+		return false;
+	}
+}
+async function isDirectory(target) {
+	try {
+		return (await stat(target)).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** Platform-native separators to POSIX, so paths in reports match everywhere. */
+function toPosix(filePath) {
+	return filePath.split(path.sep).join("/");
+}
+//#endregion
+export { toPosix as i, isDirectory as n, isFile as r, exists as t };