bsmnt 0.1.3 → 0.2.0

package/packages/create-basement-app/src/mergers/config.js

@@ -1,109 +0,0 @@
-// packages/create-basement-app/src/mergers/config.js
-
-/**
- * CMS-specific configuration for smart merge integration
- * Each CMS has its own branch, merge files, and additive paths
- */
-export const CMS_CONFIG = {
-	sanity: {
-		// Files that need smart merging (exist in both template and integration)
-		mergeFiles: [
-			"app/layout.tsx",
-			"app/sitemap.ts",
-			"lib/integrations/check-integration.ts",
-		],
-
-		// Paths that are purely additive (copy directly, no conflict)
-		additivePaths: [
-			"lib/integrations/sanity",
-			"components/ui/sanity-image",
-			"app/api/draft-mode",
-			"app/api/revalidate",
-			"app/studio",
-			"lib/utils/metadata.ts",
-			"lib/scripts/generate-page.ts",
-			"lib/scripts/copy-sanity-mcp.ts",
-			"lib/integrations/README.md",
-		],
-	},
-};
-
-/**
- * Get configuration for a specific CMS
- * @param {string} cms - The CMS name (e.g., 'sanity')
- * @returns {object|null} CMS configuration or null if not supported
- */
-export function getCmsConfig(cms) {
-	return CMS_CONFIG[cms] || null;
-}
-
-/**
- * Check if a CMS is supported
- * @param {string} cms - The CMS name
- * @returns {boolean} Whether the CMS has a configuration
- */
-export function isCmsSupported(cms) {
-	return cms in CMS_CONFIG;
-}
-
-/**
- * Technology layer configuration for overlay on next-starter base
- * Each layer defines files to replace, additive paths, and dependencies
- */
-/**
- * Technology layer configuration for overlay on next-starter base.
- *
- * next-starter already provides: clsx, tailwind-merge, zustand, zod, cva, etc.
- * Layers only add packages that are NOT in next-starter.
- */
-export const LAYER_CONFIG = {
-	// webgl and webgpu share the same template — renderer is configured via lib/renderer.ts
-	webgl: {
-		replaceFiles: ["app/page.tsx"],
-		additivePaths: [
-			"components/webgl/canvas/dynamic.tsx",
-			"components/webgl/canvas/index.tsx",
-			"components/webgl/components/scene/index.tsx",
-			"lib/renderer.ts",
-		],
-		dependencies: {
-			"@react-three/fiber": "10.0.0-alpha.2",
-			"@react-three/drei": "^11.0.0-alpha.4",
-			three: "^0.182.0",
-			"@radix-ui/react-navigation-menu": "^1.2.5",
-			leva: "^0.9.35",
-		},
-		devDependencies: {
-			"@types/three": "^0.182.0",
-		},
-	},
-
-	experiment: {
-		replaceFiles: ["components/layout/header/index.tsx"],
-		additivePaths: [
-			"components/layout/navigation-menu.tsx",
-			"lib/constants.ts",
-		],
-		dependencies: {
-			"@react-three/fiber": "^9.5.0",
-			"@react-three/drei": "^10.7.7",
-			three: "^0.182.0",
-			"class-variance-authority": "^0.7.0",
-			leva: "^0.9.35",
-			"lucide-react": "^0.474.0",
-			"@radix-ui/react-navigation-menu": "^1.2.5",
-		},
-		devDependencies: {
-			"@types/three": "^0.182.0",
-		},
-	},
-};
-
-/**
- * Get configuration for a specific technology layer
- * @param {string} layer - The layer name (e.g., 'webgl', 'webgpu', 'experiment')
- * @returns {object|null} Layer configuration or null if not found
- */
-export function getLayerConfig(layer) {
-	return LAYER_CONFIG[layer] || null;
-}

package/packages/create-basement-app/src/mergers/index.js

@@ -1,346 +0,0 @@
-// packages/create-basement-app/src/mergers/index.js
-
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import fs from "fs-extra";
-import { getCmsConfig, getLayerConfig } from "./config.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * CMS-specific merger functions (using base paths without src/ prefix)
- * Only loaded when the specific CMS is selected
- */
-const CMS_MERGERS = {
-	sanity: {
-		"app/layout.tsx": () =>
-			import("../../integrations/sanity/mergers/layout-merger.js").then(
-				(m) => m.mergeLayout,
-			),
-		"app/sitemap.ts": () =>
-			import("../../integrations/sanity/mergers/sitemap-merger.js").then(
-				(m) => m.mergeSitemap,
-			),
-		"lib/integrations/check-integration.ts": () =>
-			import(
-				"../../integrations/sanity/mergers/check-integration-merger.js"
-			).then((m) => m.mergeCheckIntegration),
-	},
-};
-
-/**
- * Detect if the target project uses src/ prefix for app, lib, components
- * @param {string} targetDir - The project directory
- * @returns {Promise<string>} Empty string or 'src/' prefix
- */
-async function detectPathPrefix(targetDir) {
-	// Check for src/app/ directory (Next.js App Router in src/)
-	const srcAppExists = await fs.pathExists(path.join(targetDir, "src/app"));
-	if (srcAppExists) {
-		return "src/";
-	}
-	return "";
-}
-
-/**
- * Transform a path by adding prefix where needed
- * Only transforms paths that start with app/, lib/, or components/
- * @param {string} filePath - Original path
- * @param {string} prefix - Prefix to add (e.g., 'src/')
- * @returns {string} Transformed path
- */
-function transformPath(filePath, prefix) {
-	if (!prefix) return filePath;
-
-	// Paths that should be prefixed when using src/ structure
-	const prefixablePaths = ["app/", "lib/", "components/"];
-
-	for (const prefixable of prefixablePaths) {
-		if (filePath.startsWith(prefixable)) {
-			return prefix + filePath;
-		}
-	}
-
-	const prefixableFiles = ["middleware.ts", "middleware.js"];
-	for (const prefixableFile of prefixableFiles) {
-		if (filePath === prefixableFile) {
-			return prefix + filePath;
-		}
-	}
-
-	return filePath;
-}
-
-/**
- * Get merger function for a specific CMS and file
- * @param {string} cms - The CMS name
- * @param {string} basePath - The base file path (without src/ prefix)
- * @returns {Promise<Function|null>} Merger function or null
- */
-async function getMerger(cms, basePath) {
-	const cmsmergers = CMS_MERGERS[cms];
-	if (!cmsmergers || !cmsmergers[basePath]) {
-		return null;
-	}
-	return await cmsmergers[basePath]();
-}
-
-/**
- * Inject CMS integration using smart merge
- * @param {string} targetDir - The project directory
- * @param {string} cms - The CMS name (e.g., 'sanity')
- * @param {object} spinner - Ora spinner for progress
- * @returns {object} Results of the merge operation
- */
-export async function injectIntegration(targetDir, cms, spinner) {
-	const results = {
-		merged: [],
-		copied: [],
-		skipped: [],
-		failed: [],
-	};
-
-	// Get CMS-specific configuration
-	const cmsConfig = getCmsConfig(cms);
-
-	if (!cmsConfig) {
-		results.failed.push({
-			path: cms,
-			error: `CMS "${cms}" is not supported. Supported: sanity`,
-		});
-		return results;
-	}
-
-	const { mergeFiles, additivePaths } = cmsConfig;
-
-	// Detect if project uses src/ prefix (e.g., src/app/ instead of app/)
-	const pathPrefix = await detectPathPrefix(targetDir);
-	if (pathPrefix) {
-		spinner.text = `Detected src/ directory structure...`;
-	}
-
-	// Resolve local integration files directory
-	const integrationDir = path.resolve(
-		__dirname,
-		"../../integrations",
-		cms,
-		"files",
-	);
-
-	if (!(await fs.pathExists(integrationDir))) {
-		results.failed.push({
-			path: cms,
-			error: `Integration directory not found: ${integrationDir}`,
-		});
-		return results;
-	}
-
-	// 1. Copy additive files/directories (CMS-specific paths)
-	spinner.text = `Adding ${cms} files...`;
-
-	for (const additivePath of additivePaths) {
-		const src = path.join(integrationDir, additivePath);
-		// Transform destination path based on project structure
-		const transformedPath = transformPath(additivePath, pathPrefix);
-		const dest = path.join(targetDir, transformedPath);
-
-		try {
-			if (await fs.pathExists(src)) {
-				await fs.copy(src, dest, { overwrite: false });
-				results.copied.push(transformedPath);
-			}
-		} catch (error) {
-			results.failed.push({ path: transformedPath, error: error.message });
-		}
-	}
-
-	// 2. Smart merge files that exist in both (CMS-specific mergers)
-	if (mergeFiles.length > 0) {
-		spinner.text = `Merging ${cms} integration...`;
-
-		for (const mergeFile of mergeFiles) {
-			// Transform path for the target project
-			const transformedPath = transformPath(mergeFile, pathPrefix);
-			const templateFile = path.join(targetDir, transformedPath);
-			const integrationFile = path.join(integrationDir, mergeFile);
-
-			try {
-				// Check if template file exists
-				if (!(await fs.pathExists(templateFile))) {
-					// Template doesn't have this file - copy from integration
-					if (await fs.pathExists(integrationFile)) {
-						await fs.ensureDir(path.dirname(templateFile));
-						await fs.copy(integrationFile, templateFile);
-						results.copied.push(transformedPath);
-					} else {
-						results.skipped.push({
-							path: transformedPath,
-							reason: "Not in integration",
-						});
-					}
-					continue;
-				}
-
-				// Check if integration file exists
-				if (!(await fs.pathExists(integrationFile))) {
-					results.skipped.push({
-						path: transformedPath,
-						reason: "Not in integration",
-					});
-					continue;
-				}
-
-				// Get the CMS-specific merger function (use base path for lookup)
-				const merger = await getMerger(cms, mergeFile);
-
-				if (merger) {
-					const result = await merger(templateFile, {
-						targetDir,
-						pathPrefix,
-					});
-					if (result.skipped) {
-						results.skipped.push({
-							path: transformedPath,
-							reason: result.reason,
-						});
-					} else {
-						results.merged.push(transformedPath);
-					}
-				} else {
-					results.skipped.push({
-						path: transformedPath,
-						reason: `No merger for ${cms}`,
-					});
-				}
-			} catch (error) {
-				results.failed.push({ path: transformedPath, error: error.message });
-			}
-		}
-	}
-
-	return results;
-}
-
-/**
- * Inject technology layer files on top of next-starter base
- * @param {string} targetDir - The project directory
- * @param {string} layer - The layer name (e.g., 'webgl', 'webgpu', 'experiment')
- * @param {object} spinner - Ora spinner for progress
- * @returns {object} Results of the layer injection
- */
-export async function injectLayer(targetDir, layer, spinner) {
-	const results = {
-		replaced: [],
-		copied: [],
-		skipped: [],
-		failed: [],
-	};
-
-	const layerConfig = getLayerConfig(layer);
-
-	if (!layerConfig || layer === "default") {
-		results.skipped.push({ path: layer, reason: "No layer to apply" });
-		return results;
-	}
-
-	// Resolve the layer directory from create-basement-app's templates/{type}/ path
-	const layerDir = path.resolve(__dirname, "../../templates", layer);
-
-	if (!(await fs.pathExists(layerDir))) {
-		results.skipped.push({
-			path: layer,
-			reason: `Layer directory not found: ${layerDir}`,
-		});
-		return results;
-	}
-
-	// Detect if project uses src/ prefix
-	const pathPrefix = await detectPathPrefix(targetDir);
-	if (pathPrefix && spinner) {
-		spinner.text = `Detected src/ directory structure...`;
-	}
-
-	const { replaceFiles, additivePaths } = layerConfig;
-
-	// 1. Replace files (overwrite base version)
-	for (const replaceFile of replaceFiles) {
-		const src = path.join(layerDir, replaceFile);
-		const transformedPath = transformPath(replaceFile, pathPrefix);
-		const dest = path.join(targetDir, transformedPath);
-
-		try {
-			if (await fs.pathExists(src)) {
-				await fs.ensureDir(path.dirname(dest));
-				await fs.copy(src, dest, { overwrite: true });
-				results.replaced.push(transformedPath);
-			} else {
-				results.skipped.push({
-					path: transformedPath,
-					reason: "Source file not found in layer",
-				});
-			}
-		} catch (error) {
-			results.failed.push({ path: transformedPath, error: error.message });
-		}
-	}
-
-	// 2. Copy additive files
-	for (const additivePath of additivePaths) {
-		const src = path.join(layerDir, additivePath);
-		const transformedPath = transformPath(additivePath, pathPrefix);
-		const dest = path.join(targetDir, transformedPath);
-
-		try {
-			if (await fs.pathExists(src)) {
-				await fs.ensureDir(path.dirname(dest));
-				await fs.copy(src, dest, { overwrite: false });
-				results.copied.push(transformedPath);
-			} else {
-				results.skipped.push({
-					path: transformedPath,
-					reason: "Source file not found in layer",
-				});
-			}
-		} catch (error) {
-			results.failed.push({ path: transformedPath, error: error.message });
-		}
-	}
-
-	return results;
-}
-
-/**
- * Format merge results for display
- * @param {object} results - Results from injectIntegration or injectLayer
- * @returns {string[]} Lines to display
- */
-export function formatMergeResults(results) {
-	const lines = [];
-
-	if (results.replaced && results.replaced.length > 0) {
-		lines.push(...results.replaced.map((f) => `  ✓ Replaced: ${f}`));
-	}
-
-	if (results.merged && results.merged.length > 0) {
-		lines.push(...results.merged.map((f) => `  ✓ Merged: ${f}`));
-	}
-
-	if (results.copied && results.copied.length > 0) {
-		lines.push(...results.copied.map((f) => `  ✓ Added: ${f}`));
-	}
-
-	if (results.skipped && results.skipped.length > 0) {
-		lines.push(
-			...results.skipped.map((s) => `  ○ Skipped: ${s.path} (${s.reason})`),
-		);
-	}
-
-	if (results.failed && results.failed.length > 0) {
-		lines.push(
-			...results.failed.map((f) => `  ✗ Failed: ${f.path} (${f.error})`),
-		);
-	}
-
-	return lines;
-}

package/packages/create-basement-app/src/mergers/layout-merger.js

@@ -1,223 +0,0 @@
-// packages/create-basement-app/src/mergers/layout-merger.js
-
-import path from "node:path";
-import fs from "fs-extra";
-
-/**
- * Sanity-specific imports to inject into layout.
- * Only two lightweight components — no dynamic functions (draftMode, headers, etc.)
- */
-const SANITY_IMPORTS = `import { SanityStudioGuard } from "@/components/sanity/studio-guard"
-import { SanityVisualEditing } from "@/components/sanity/visual-editing"`;
-
-/**
- * Client component that hides site chrome on /studio routes.
- * Uses useSelectedLayoutSegment() — a stable Next.js client API.
- */
-const STUDIO_GUARD_COMPONENT = `"use client"
-
-import { useSelectedLayoutSegment } from "next/navigation"
-
-export function SanityStudioGuard({ children }: { children: React.ReactNode }) {
-  const segment = useSelectedLayoutSegment()
-  if (segment === "studio") return null
-  return <>{children}</>
-}
-`;
-
-/**
- * Server component that handles Sanity visual editing.
- * Keeps draftMode() inside its own <Suspense> boundary so the root layout
- * never calls dynamic functions directly — preserving static rendering.
- */
-const VISUAL_EDITING_COMPONENT = `import { Suspense } from "react"
-import { draftMode } from "next/headers"
-import { VisualEditing } from "next-sanity/visual-editing"
-import { isSanityConfigured } from "@/lib/integrations/check-integration"
-import { SanityLive } from "@/lib/integrations/sanity/live"
-
-async function VisualEditingInner() {
-  const { isEnabled: isDraftMode } = await draftMode()
-  const sanityConfigured = isSanityConfigured()
-
-  if (!sanityConfigured || !isDraftMode) return null
-
-  return (
-    <>
-      <VisualEditing />
-      <SanityLive />
-    </>
-  )
-}
-
-export function SanityVisualEditing() {
-  return (
-    <Suspense fallback={null}>
-      <VisualEditingInner />
-    </Suspense>
-  )
-}
-`;
-
-/**
- * Merge Sanity integration into template layout.
- * The layout itself stays free of dynamic functions (draftMode, headers, etc.)
- * All dynamic behavior is encapsulated in generated components.
- *
- * Strategy:
- * 1. Inject two imports (SanityStudioGuard, SanityVisualEditing)
- * 2. Wrap body chrome in <SanityStudioGuard>
- * 3. Add <SanityVisualEditing /> before </body>
- * 4. Generate the two component files
- *
- * @param {string} templatePath - Path to the template's layout.tsx
- * @param {object} options - Options from the merge orchestrator
- * @param {string} options.targetDir - The project root directory
- * @param {string} options.pathPrefix - Path prefix (e.g., 'src/' or '')
- * @returns {Promise<{skipped?: boolean, reason?: string, success?: boolean}>}
- */
-export async function mergeLayout(
-	templatePath,
-	{ targetDir, pathPrefix } = {},
-) {
-	let content = await fs.readFile(templatePath, "utf-8");
-
-	// Skip if already has Sanity integration
-	if (
-		content.includes("SanityStudioGuard") ||
-		content.includes("isSanityConfigured")
-	) {
-		return { skipped: true, reason: "Already has Sanity integration" };
-	}
-
-	// 1. Add Sanity imports after existing imports
-	const importMatches = [...content.matchAll(/^import .+$/gm)];
-	if (importMatches.length > 0) {
-		const lastImport = importMatches[importMatches.length - 1];
-		const insertPos = lastImport.index + lastImport[0].length;
-		content =
-			content.slice(0, insertPos) +
-			"\n" +
-			SANITY_IMPORTS +
-			content.slice(insertPos);
-	}
-
-	// 2. Ensure Suspense is imported from react
-	if (!content.match(/import\s+.*Suspense.*from\s+["']react["']/)) {
-		const reactImportMatch = content.match(
-			/import\s+\{([^}]*)\}\s+from\s+["']react["']/,
-		);
-		if (reactImportMatch) {
-			if (!reactImportMatch[1].includes("Suspense")) {
-				content = content.replace(
-					reactImportMatch[0],
-					reactImportMatch[0].replace(
-						reactImportMatch[1],
-						`${reactImportMatch[1].trim()}, Suspense`,
-					),
-				);
-			}
-		} else {
-			const lastImportMatch = content.match(/^(import\s+.+\n)/gm);
-			if (lastImportMatch) {
-				const lastImport = lastImportMatch[lastImportMatch.length - 1];
-				content = content.replace(
-					lastImport,
-					`${lastImport}import { Suspense } from "react"\n`,
-				);
-			}
-		}
-	}
-
-	// 3. Wrap body chrome in <SanityStudioGuard> and add <SanityVisualEditing />
-	content = content.replace(
-		/(\s*)(<body[^>]*>)([\s\S]*?)(\{children\})([\s\S]*?)(<\/body>)/m,
-		(
-			_match,
-			bodyIndent,
-			bodyOpen,
-			beforeChildren,
-			_childrenExpr,
-			afterChildren,
-			bodyClose,
-		) => {
-			const baseIndent = bodyIndent || "        ";
-			const indent = `${baseIndent}  `;
-			const innerIndent = `${indent}  `;
-
-			const trimmedBefore = beforeChildren.trim();
-			const trimmedAfter = afterChildren.trim();
-			const hasChrome = trimmedBefore.length > 0 || trimmedAfter.length > 0;
-
-			// Preserve relative indentation of chrome content
-			const reindent = (text, targetIndent) => {
-				const lines = text.split("\n").filter((line) => line.trim());
-				if (lines.length === 0) return "";
-				const minIndent = Math.min(
-					...lines
-						.map((line) => line.match(/^(\s*)/)[1].length)
-						.filter((n) => n > 0),
-					Infinity,
-				);
-				return lines
-					.map((line) => {
-						const currentIndent = line.match(/^(\s*)/)[1].length;
-						const relativeIndent = Math.max(
-							0,
-							currentIndent - (minIndent === Infinity ? 0 : minIndent),
-						);
-						return targetIndent + " ".repeat(relativeIndent) + line.trim();
-					})
-					.join("\n");
-			};
-
-			let result = `${baseIndent}${bodyOpen}\n`;
-
-			if (hasChrome && trimmedBefore) {
-				result += `${indent}<Suspense fallback={null}>\n`;
-				result += `${innerIndent}<SanityStudioGuard>\n`;
-				result += reindent(trimmedBefore, `${innerIndent}  `);
-				result += `\n${innerIndent}</SanityStudioGuard>\n`;
-				result += `${indent}</Suspense>\n\n`;
-			}
-
-			result += `${indent}{children}\n`;
-
-			if (hasChrome && trimmedAfter) {
-				result += `\n${indent}<Suspense fallback={null}>\n`;
-				result += `${innerIndent}<SanityStudioGuard>\n`;
-				result += reindent(trimmedAfter, `${innerIndent}  `);
-				result += `\n${innerIndent}</SanityStudioGuard>\n`;
-				result += `${indent}</Suspense>\n`;
-			}
-
-			result += `\n${indent}<SanityVisualEditing />\n${baseIndent}${bodyClose}`;
-			return result;
-		},
-	);
-
-	await fs.writeFile(templatePath, content);
-
-	// 3. Generate component files
-	if (targetDir) {
-		const sanityDir = path.join(
-			targetDir,
-			pathPrefix || "",
-			"components",
-			"sanity",
-		);
-		await fs.ensureDir(sanityDir);
-
-		const guardPath = path.join(sanityDir, "studio-guard.tsx");
-		if (!(await fs.pathExists(guardPath))) {
-			await fs.writeFile(guardPath, STUDIO_GUARD_COMPONENT);
-		}
-
-		const visualEditingPath = path.join(sanityDir, "visual-editing.tsx");
-		if (!(await fs.pathExists(visualEditingPath))) {
-			await fs.writeFile(visualEditingPath, VISUAL_EDITING_COMPONENT);
-		}
-	}
-
-	return { success: true };
-}