@contentrain/mcp 0.3.1 → 1.0.0

package/dist/scan-config-AJGxCdNd.mjs

@@ -0,0 +1,159 @@
+import { r as pathExists } from "./fs-BbuGnVcG.mjs";
+import { basename, extname, join } from "node:path";
+import { readdir } from "node:fs/promises";
+//#region src/core/scan-config.ts
+/** File extensions to scan across all JS/TS ecosystem projects */
+const SCAN_EXTENSIONS = new Set([
+	".tsx",
+	".jsx",
+	".vue",
+	".ts",
+	".js",
+	".mjs",
+	".astro",
+	".svelte"
+]);
+/** Directory names to always exclude from scanning */
+const SCAN_IGNORE_DIRS = new Set([
+	"node_modules",
+	".pnpm",
+	"dist",
+	"build",
+	"out",
+	".output",
+	".nuxt",
+	".next",
+	".svelte-kit",
+	".expo",
+	".turbo",
+	".parcel-cache",
+	".vercel",
+	".netlify",
+	"coverage",
+	"__tests__",
+	"__mocks__",
+	".git",
+	".vscode",
+	".idea",
+	".contentrain"
+]);
+/** Max files per scan operation */
+const MAX_SCAN_FILES = 500;
+/** File patterns to skip regardless of extension */
+const SKIP_FILE_RE = /\.(test|spec)\.[^.]+$|\.d\.ts$|\.min\.[^.]+$/;
+/** Directories that represent entry points / pages / screens */
+const PAGE_DIR_NAMES = new Set([
+	"pages",
+	"routes",
+	"screens",
+	"views",
+	"controllers",
+	"handlers",
+	"resolvers"
+]);
+/** Directories that represent reusable components / modules */
+const COMPONENT_DIR_NAMES = new Set([
+	"components",
+	"ui",
+	"widgets",
+	"elements",
+	"features",
+	"modules",
+	"services",
+	"providers",
+	"shared",
+	"common"
+]);
+/** Directories that represent layouts / templates */
+const LAYOUT_DIR_NAMES = new Set(["layouts", "templates"]);
+/** Next.js App Router special files that are page-like */
+const NEXTJS_PAGE_FILES = new Set([
+	"page.tsx",
+	"page.jsx",
+	"page.ts",
+	"page.js",
+	"layout.tsx",
+	"layout.jsx",
+	"layout.ts",
+	"layout.js",
+	"error.tsx",
+	"error.jsx",
+	"loading.tsx",
+	"loading.jsx",
+	"not-found.tsx",
+	"not-found.jsx"
+]);
+/** Classify a file into page/component/layout/other based on path heuristics */
+function classifyFile(relPath) {
+	const parts = relPath.split("/");
+	const fileName = parts[parts.length - 1] ?? "";
+	if (parts.includes("app") && NEXTJS_PAGE_FILES.has(fileName)) return fileName.startsWith("layout") ? "layout" : "page";
+	for (const part of parts) {
+		const lower = part.toLowerCase();
+		if (LAYOUT_DIR_NAMES.has(lower)) return "layout";
+		if (PAGE_DIR_NAMES.has(lower)) return "page";
+		if (COMPONENT_DIR_NAMES.has(lower)) return "component";
+	}
+	return "other";
+}
+/** Common source directories across all JS/TS project types */
+const AUTO_DETECT_DIRS = [
+	"src",
+	"app",
+	"lib",
+	"pages",
+	"components",
+	"layouts",
+	"views",
+	"screens",
+	"modules",
+	"routes",
+	"controllers",
+	"services",
+	"features",
+	"shared",
+	"common",
+	"hooks",
+	"composables",
+	"stores"
+];
+/** Auto-detect which source directories exist in the project */
+async function autoDetectSourceDirs(projectRoot) {
+	const found = [];
+	for (const dir of AUTO_DETECT_DIRS) if (await pathExists(join(projectRoot, dir))) found.push(dir);
+	return found.length > 0 ? found : ["."];
+}
+/**
+* Discover source files matching scan criteria.
+* Returns relative paths (relative to projectRoot).
+*/
+async function discoverFiles(projectRoot, options) {
+	const extensions = options?.include ? new Set(options.include.map((e) => e.startsWith(".") ? e : `.${e}`)) : SCAN_EXTENSIONS;
+	const extraExcludes = new Set(options?.exclude ?? []);
+	const scanDirs = options?.paths ?? await autoDetectSourceDirs(projectRoot);
+	const files = [];
+	for (const dir of scanDirs) {
+		const absDir = join(projectRoot, dir);
+		if (!await pathExists(absDir)) continue;
+		let entries;
+		try {
+			entries = await readdir(absDir, { recursive: true });
+		} catch {
+			continue;
+		}
+		for (const entry of entries) {
+			if (files.length >= 500) break;
+			const fileName = basename(entry);
+			if (entry.split("/").some((seg) => SCAN_IGNORE_DIRS.has(seg) || extraExcludes.has(seg))) continue;
+			if (!extensions.has(extname(fileName))) continue;
+			if (SKIP_FILE_RE.test(fileName)) continue;
+			files.push(join(dir, entry));
+		}
+		if (files.length >= 500) break;
+	}
+	return files.toSorted((a, b) => a.localeCompare(b)).slice(0, 500);
+}
+//#endregion
+export { classifyFile as a, autoDetectSourceDirs as i, SCAN_EXTENSIONS as n, discoverFiles as o, SCAN_IGNORE_DIRS as r, MAX_SCAN_FILES as t };
+
+//# sourceMappingURL=scan-config-AJGxCdNd.mjs.map

package/dist/scan-config-AJGxCdNd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-config-AJGxCdNd.mjs","names":[],"sources":["../src/core/scan-config.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises'\nimport { join, extname, basename } from 'node:path'\nimport { pathExists } from '../util/fs.js'\n\n// ─── Shared Scan Constants ───\n\n/** File extensions to scan across all JS/TS ecosystem projects */\nexport const SCAN_EXTENSIONS = new Set([\n  '.tsx', '.jsx', '.vue', '.ts', '.js', '.mjs', '.astro', '.svelte',\n])\n\n/** Directory names to always exclude from scanning */\nexport const SCAN_IGNORE_DIRS = new Set([\n  // Package managers / deps\n  'node_modules', '.pnpm',\n  // Build outputs\n  'dist', 'build', 'out', '.output',\n  // Framework caches\n  '.nuxt', '.next', '.svelte-kit', '.expo', '.turbo', '.parcel-cache', '.vercel', '.netlify',\n  // Test / coverage\n  'coverage', '__tests__', '__mocks__',\n  // VCS / IDE\n  '.git', '.vscode', '.idea',\n  // Contentrain\n  '.contentrain',\n])\n\n/** Max files per scan operation */\nexport const MAX_SCAN_FILES = 500\n\n/** File patterns to skip regardless of extension */\nconst SKIP_FILE_RE = /\\.(test|spec)\\.[^.]+$|\\.d\\.ts$|\\.min\\.[^.]+$/\n\n// ─── File Classification ───\n// Covers: React, Next.js, Nuxt, Vue, Astro, SvelteKit, Remix,\n//         React Native/Expo, NestJS, Express, Fastify, Koa, Hapi\n\n/** Directories that represent entry points / pages / screens */\nconst PAGE_DIR_NAMES = new Set([\n  // Frontend routing\n  'pages', 'routes', 'screens', 'views',\n  // Backend entry points\n  'controllers', 'handlers', 'resolvers',\n])\n\n/** Directories that represent reusable components / modules */\nconst COMPONENT_DIR_NAMES = new Set([\n  // UI components\n  'components', 'ui', 'widgets', 'elements',\n  // Feature modules\n  'features', 'modules',\n  // Backend services\n  'services', 'providers',\n  // Shared / common\n  'shared', 'common',\n])\n\n/** Directories that represent layouts / templates */\nconst LAYOUT_DIR_NAMES = new Set([\n  'layouts', 'templates',\n])\n\n/** Next.js App Router special files that are page-like */\nconst NEXTJS_PAGE_FILES = new Set([\n  'page.tsx', 'page.jsx', 'page.ts', 'page.js',\n  'layout.tsx', 'layout.jsx', 'layout.ts', 'layout.js',\n  'error.tsx', 'error.jsx',\n  'loading.tsx', 'loading.jsx',\n  'not-found.tsx', 'not-found.jsx',\n])\n\n/** Classify a file into page/component/layout/other based on path heuristics */\nexport function classifyFile(relPath: string): 'page' | 'component' | 'layout' | 'other' {\n  const parts = relPath.split('/')\n  const fileName = parts[parts.length - 1] ?? ''\n\n  // Next.js App Router: files in app/ with special names are pages\n  if (parts.includes('app') && NEXTJS_PAGE_FILES.has(fileName)) {\n    return fileName.startsWith('layout') ? 'layout' : 'page'\n  }\n\n  // Check directory names in path (check layout first — more specific)\n  for (const part of parts) {\n    const lower = part.toLowerCase()\n    if (LAYOUT_DIR_NAMES.has(lower)) return 'layout'\n    if (PAGE_DIR_NAMES.has(lower)) return 'page'\n    if (COMPONENT_DIR_NAMES.has(lower)) return 'component'\n  }\n\n  return 'other'\n}\n\n// ─── Source Directory Detection ───\n\n/** Common source directories across all JS/TS project types */\nconst AUTO_DETECT_DIRS = [\n  // Standard source\n  'src', 'app', 'lib',\n  // Frontend specific\n  'pages', 'components', 'layouts', 'views',\n  // Mobile\n  'screens',\n  // Backend\n  'modules', 'routes', 'controllers', 'services',\n  // Shared\n  'features', 'shared', 'common',\n  // Hooks / composables\n  'hooks', 'composables',\n  // Stores\n  'stores',\n]\n\n/** Auto-detect which source directories exist in the project */\nexport async function autoDetectSourceDirs(projectRoot: string): Promise<string[]> {\n  const found: string[] = []\n  for (const dir of AUTO_DETECT_DIRS) {\n    if (await pathExists(join(projectRoot, dir))) {\n      found.push(dir)\n    }\n  }\n  return found.length > 0 ? found : ['.']\n}\n\n// ─── File Discovery ───\n\nexport interface DiscoverFilesOptions {\n  paths?: string[]\n  include?: string[]\n  exclude?: string[]\n}\n\n/**\n * Discover source files matching scan criteria.\n * Returns relative paths (relative to projectRoot).\n */\nexport async function discoverFiles(\n  projectRoot: string,\n  options?: DiscoverFilesOptions,\n): Promise<string[]> {\n  const extensions = options?.include\n    ? new Set(options.include.map(e => e.startsWith('.') ? e : `.${e}`))\n    : SCAN_EXTENSIONS\n  const extraExcludes = new Set(options?.exclude ?? [])\n  const scanDirs = options?.paths ?? await autoDetectSourceDirs(projectRoot)\n\n  const files: string[] = []\n\n  for (const dir of scanDirs) {\n    const absDir = join(projectRoot, dir)\n    if (!(await pathExists(absDir))) continue\n\n    let entries: string[]\n    try {\n      entries = await readdir(absDir, { recursive: true }) as unknown as string[]\n    } catch {\n      continue\n    }\n\n    for (const entry of entries) {\n      if (files.length >= MAX_SCAN_FILES) break\n\n      const fileName = basename(entry)\n\n      // Check if any path segment is excluded\n      const pathSegments = entry.split('/')\n      if (pathSegments.some(seg => SCAN_IGNORE_DIRS.has(seg) || extraExcludes.has(seg))) continue\n\n      // Check extension\n      if (!extensions.has(extname(fileName))) continue\n\n      // Skip test/spec/declaration/minified files\n      if (SKIP_FILE_RE.test(fileName)) continue\n\n      files.push(join(dir, entry))\n    }\n\n    if (files.length >= MAX_SCAN_FILES) break\n  }\n\n  return files.toSorted((a, b) => a.localeCompare(b)).slice(0, MAX_SCAN_FILES)\n}\n"],"mappings":"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"}