bsmnt 0.0.0

package/src/mergers/check-integration-merger.js

@@ -0,0 +1,105 @@
+// src/mergers/check-integration-merger.js
+import fs from "fs-extra";
+
+/**
+ * Sanity configuration check function to add
+ */
+const SANITY_FUNCTION = `
+/**
+ * Check if Sanity CMS is configured
+ * Requires: NEXT_PUBLIC_SANITY_PROJECT_ID and NEXT_PUBLIC_SANITY_DATASET
+ */
+export function isSanityConfigured(): boolean {
+  return Boolean(
+    process.env.NEXT_PUBLIC_SANITY_PROJECT_ID &&
+      process.env.NEXT_PUBLIC_SANITY_DATASET
+  )
+}
+`;
+
+/**
+ * Update to getConfiguredIntegrations to include Sanity
+ */
+const SANITY_CONFIGURED_CHECK = `  if (isSanityConfigured()) integrations.push("Sanity")`;
+
+/**
+ * Update to getUnconfiguredIntegrations to include Sanity
+ */
+const SANITY_UNCONFIGURED_CHECK = `  if (!isSanityConfigured()) integrations.push("Sanity")`;
+
+/**
+ * Merge Sanity integration into template check-integration
+ * @param {string} templatePath - Path to the template's check-integration.ts
+ * @returns {Promise<{skipped?: boolean, reason?: string, success?: boolean}>}
+ */
+export async function mergeCheckIntegration(templatePath) {
+	let content = await fs.readFile(templatePath, "utf-8");
+
+	// Skip if already has isSanityConfigured
+	if (content.includes("isSanityConfigured")) {
+		return { skipped: true, reason: "Already has isSanityConfigured" };
+	}
+
+	// 1. Add isSanityConfigured function after isAnalyticsConfigured
+	const analyticsMatch = content.match(
+		/(export function isAnalyticsConfigured\(\)[^}]+\})/s,
+	);
+	if (analyticsMatch) {
+		const insertPos = analyticsMatch.index + analyticsMatch[0].length;
+		content =
+			content.slice(0, insertPos) +
+			"\n" +
+			SANITY_FUNCTION +
+			content.slice(insertPos);
+	} else {
+		// If no isAnalyticsConfigured, add before getConfiguredIntegrations
+		const getConfiguredMatch = content.match(
+			/export function getConfiguredIntegrations/,
+		);
+		if (getConfiguredMatch) {
+			content =
+				content.slice(0, getConfiguredMatch.index) +
+				SANITY_FUNCTION +
+				"\n" +
+				content.slice(getConfiguredMatch.index);
+		} else {
+			// Fallback: append to end
+			content = `${content.trimEnd()}\n${SANITY_FUNCTION}`;
+		}
+	}
+
+	// 2. Update getConfiguredIntegrations to include Sanity check
+	const configuredFnMatch = content.match(
+		/(export function getConfiguredIntegrations\(\)[^{]*\{[\s\S]*?)(if \(isAnalyticsConfigured\(\)\))/m,
+	);
+	if (configuredFnMatch) {
+		const insertPos = content.indexOf(
+			configuredFnMatch[2],
+			configuredFnMatch.index,
+		);
+		content =
+			content.slice(0, insertPos) +
+			SANITY_CONFIGURED_CHECK +
+			"\n  " +
+			content.slice(insertPos);
+	}
+
+	// 3. Update getUnconfiguredIntegrations to include Sanity check
+	const unconfiguredFnMatch = content.match(
+		/(export function getUnconfiguredIntegrations\(\)[^{]*\{[\s\S]*?)(if \(!isAnalyticsConfigured\(\)\))/m,
+	);
+	if (unconfiguredFnMatch) {
+		const insertPos = content.indexOf(
+			unconfiguredFnMatch[2],
+			unconfiguredFnMatch.index,
+		);
+		content =
+			content.slice(0, insertPos) +
+			SANITY_UNCONFIGURED_CHECK +
+			"\n  " +
+			content.slice(insertPos);
+	}
+
+	await fs.writeFile(templatePath, content);
+	return { success: true };
+}

package/src/mergers/config.js

@@ -0,0 +1,137 @@
+// 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: {
+		// Git branch containing the Sanity integration files
+		branch: "sanity-integration",
+
+		// 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",
+		],
+	},
+
+	basehub: {
+		// Git branch containing the BaseHub integration files
+		branch: "basehub-integration",
+
+		// Files that need smart merging for BaseHub
+		mergeFiles: [],
+
+		// Paths that are purely additive for BaseHub
+		additivePaths: ["lib/integrations/basehub"],
+	},
+};
+
+/**
+ * Get configuration for a specific CMS
+ * @param {string} cms - The CMS name (e.g., 'sanity', 'basehub')
+ * @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: {
+		replaceFiles: ["app/page.tsx"],
+		additivePaths: [
+			"components/webgl/canvas/dynamic.tsx",
+			"components/webgl/canvas/index.tsx",
+			"components/webgl/components/scene/index.tsx",
+		],
+		dependencies: {
+			"@react-three/fiber": "^9.5.0",
+			"@react-three/drei": "^10.7.7",
+			three: "^0.182.0",
+			"@radix-ui/react-navigation-menu": "^1.2.5",
+			leva: "^0.9.35",
+		},
+		devDependencies: {
+			"@types/three": "^0.182.0",
+		},
+	},
+
+	webgpu: {
+		replaceFiles: [],
+		additivePaths: [],
+		dependencies: {
+			"@react-three/fiber": "10.0.0-alpha.2",
+			"@react-three/drei": "^11.0.0-alpha.4",
+			three: "^0.182.0",
+			leva: "^0.9.35",
+			"lucide-react": "^0.474.0",
+			"@radix-ui/react-navigation-menu": "^1.2.5",
+		},
+		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/src/mergers/index.js

@@ -0,0 +1,355 @@
+// src/mergers/index.js
+
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import fs from "fs-extra";
+import tiged from "tiged";
+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("./layout-merger.js").then((m) => m.mergeLayout),
+		"app/sitemap.ts": () =>
+			import("./sitemap-merger.js").then((m) => m.mergeSitemap),
+		"lib/integrations/check-integration.ts": () =>
+			import("./check-integration-merger.js").then(
+				(m) => m.mergeCheckIntegration,
+			),
+	},
+	basehub: {
+		// BaseHub mergers would go here when implemented
+	},
+};
+
+/**
+ * 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', 'basehub')
+ * @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, basehub`,
+		});
+		return results;
+	}
+
+	const { branch, 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...`;
+	}
+
+	// 1. Clone integration to temp directory
+	const tempDir = path.join(os.tmpdir(), `integration-${Date.now()}`);
+
+	try {
+		spinner.text = `Downloading ${cms} integration...`;
+
+		// Use CMS-specific branch
+		const integrationRepoPath = `github:basementstudio/basement-cli/integrations/${cms}#${branch}`;
+		const emitter = tiged(integrationRepoPath, {
+			cache: false,
+			force: true,
+			mode: "git",
+		});
+
+		await emitter.clone(tempDir);
+
+		// 2. Copy additive files/directories (CMS-specific paths)
+		spinner.text = `Adding ${cms} files...`;
+
+		for (const additivePath of additivePaths) {
+			const src = path.join(tempDir, 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 });
+			}
+		}
+
+		// 3. 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(tempDir, 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 });
+				}
+			}
+		}
+	} finally {
+		// 4. Cleanup temp directory
+		try {
+			await fs.remove(tempDir);
+		} catch {
+			// Ignore cleanup errors
+		}
+	}
+
+	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 the CLI repo's layers/{type}/ path
+	const layerDir = path.resolve(__dirname, "../../layers", 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;
+}