bsmnt 0.0.2 → 0.1.1

package/{src → packages/cli/src}/commands/create.js

@@ -1,23 +1,50 @@
 import { execSync } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import dotenv from "dotenv";
 import fs from "fs-extra";
 import ora from "ora";
 import pc from "picocolors";
 import prompts from "prompts";
-import tiged from "tiged";
-import { getLayerConfig } from "../mergers/config.js";
+import { sanityConfig } from "../../../create-basement-app/integrations/sanity/config.js";
+import { getAnimationConfig } from "../../../create-basement-app/src/configs/animations.js";
+import { hooksConfig } from "../../../create-basement-app/template-hooks/config.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-dotenv.config({ path: path.resolve(__dirname, "../../.env") });
-
 /**
- * Creates a new project by downloading a template from GitHub.
+ * Creates a new project by copying a local standalone template.
  */
 export async function createProject(projectName, options = {}) {
+	// Discover available templates dynamically from create-basement-app/templates/
+	const templatesDir = path.resolve(
+		__dirname,
+		"../../../create-basement-app/templates",
+	);
+	const discoveredTemplates = (
+		await fs.readdir(templatesDir, { withFileTypes: true })
+	)
+		.filter((d) => d.isDirectory())
+		.map((d) => d.name);
+
+	// Virtual templates that alias to an existing template folder
+	const TEMPLATE_ALIASES = { webgpu: "webgl" };
+
+	// Build full list: discovered folders + virtual aliases (preserving order)
+	const templateNames = [
+		...discoveredTemplates,
+		...Object.keys(TEMPLATE_ALIASES).filter(
+			(v) => !discoveredTemplates.includes(v),
+		),
+	];
+
+	const templateLabels = {
+		default: "Default (Next.js Starter)",
+		webgl: "WebGL (3D Graphics)",
+		webgpu: "WebGPU (Next-gen Graphics)",
+		experiment: "Experiment (Creative Coding)",
+	};
+
 	// 1. Interactive Prompts (skip if flag provided)
 	const answers = await prompts([
 		{
@@ -34,12 +61,10 @@ export async function createProject(projectName, options = {}) {
 			type: options.template ? null : "select",
 			name: "projectType",
 			message: "What type of project are you building?",
-			choices: [
-				{ title: "Default (Next.js Starter)", value: "default" },
-				{ title: "WebGL (3D Graphics)", value: "webgl" },
-				{ title: "WebGPU (Next-gen Graphics)", value: "webgpu" },
-				{ title: "Experiment (Creative Coding)", value: "experiment" },
-			],
+			choices: templateNames.map((name) => ({
+				title: templateLabels[name] || name,
+				value: name,
+			})),
 		},
 		{
 			type: options.cms ? null : "select",
@@ -47,7 +72,6 @@ export async function createProject(projectName, options = {}) {
 			message: "Which CMS will you use?",
 			choices: [
 				{ title: "Sanity", value: "sanity" },
-				{ title: "BaseHub", value: "basehub" },
 				{ title: "None", value: "none" },
 			],
 		},
@@ -74,13 +98,7 @@ export async function createProject(projectName, options = {}) {
 			type: options.hooks !== undefined ? null : "multiselect",
 			name: "hooks",
 			message: "Select hooks you want to add:",
-			choices: async () => {
-				const hooksPath = path.join(__dirname, "..", "..", "template-hooks");
-				const files = await fs.readdir(hooksPath);
-				return files
-					.filter((f) => f.endsWith(".ts"))
-					.map((f) => ({ title: f.replace(".ts", ""), value: f }));
-			},
+			choices: hooksConfig.map((h) => ({ title: h.name, value: h.file })),
 		},
 	]);
 
@@ -114,76 +132,46 @@ export async function createProject(projectName, options = {}) {
 		await fs.remove(targetDir);
 	}
 
-	// 3. Download from GitHub
-	const downloadSpinner = ora(
-		`Downloading next-starter from GitHub...`,
-	).start();
-
-	const repoPath = `github:basementstudio/next-starter#main`;
-	const emitter = tiged(repoPath, {
-		cache: false,
-		force: true,
-		verbose: true,
-		mode: "git",
-	});
-
-	// Diagnostic logging
-	emitter.on("info", (info) => {
-		downloadSpinner.text = pc.dim(`[tiged] ${info.message}`);
-	});
-
-	emitter.on("warn", (warning) => {
-		console.warn(pc.yellow(`\n⚠ [tiged] ${warning.message}`));
-	});
+	// 3. Copy local template (standalone, no network call)
+	const actualTemplate = TEMPLATE_ALIASES[type] || type;
+	const templateDir = path.resolve(
+		__dirname,
+		"../../../create-basement-app/templates",
+		actualTemplate,
+	);
+	const copySpinner = ora(`Copying ${pc.cyan(type)} template...`).start();
 
 	try {
-		await emitter.clone(targetDir);
+		await fs.copy(templateDir, targetDir);
 
-		// Delete bun.lock since dependencies will be modified by layers/CMS/animation
-		const bunLockPath = path.join(targetDir, "bun.lock");
-		if (fs.existsSync(bunLockPath)) {
-			await fs.remove(bunLockPath);
+		// Rename _gitignore to .gitignore (npm strips dotfiles from published packages)
+		const underscoreGitignore = path.join(targetDir, "_gitignore");
+		if (await fs.pathExists(underscoreGitignore)) {
+			await fs.rename(underscoreGitignore, path.join(targetDir, ".gitignore"));
 		}
 
-		downloadSpinner.succeed(pc.green("Template downloaded."));
-
-		// 3.2. Inject Technology Layer
-		if (type && type !== "default") {
-			const layerSpinner = ora(`Applying ${pc.cyan(type)} layer...`).start();
-
-			try {
-				const { injectLayer, formatMergeResults } = await import(
-					"../mergers/index.js"
-				);
-				const layerResults = await injectLayer(targetDir, type, layerSpinner);
-
-				const hasErrors = layerResults.failed.length > 0;
-				const resultLines = formatMergeResults(layerResults);
-
-				if (hasErrors) {
-					layerSpinner.warn(pc.yellow(`${type} layer applied with warnings:`));
-				} else {
-					layerSpinner.succeed(pc.green(`${type} layer applied:`));
-				}
-
-				for (const line of resultLines) {
-					console.log(pc.dim(line));
-				}
-			} catch (e) {
-				console.warn(
-					pc.yellow(`\n⚠ Failed to apply ${type} layer: ${e.message}`),
+		// Configure renderer for aliased templates (e.g. webgpu uses webgl template with WebGPU renderer)
+		if (type === "webgpu") {
+			const rendererPath = path.join(targetDir, "lib/renderer.ts");
+			if (await fs.pathExists(rendererPath)) {
+				let content = await fs.readFile(rendererPath, "utf-8");
+				content = content.replace(
+					"export const FORCE_WEBGL = true",
+					"export const FORCE_WEBGL = false",
 				);
-				console.log(pc.dim("  Continuing with base template..."));
+				await fs.writeFile(rendererPath, content);
 			}
 		}
 
+		copySpinner.succeed(pc.green(`${type} template copied.`));
+
 		// 3.5. Inject Integration Files (Smart Merge)
 		if (cms && cms !== "none") {
 			const integrationSpinner = ora(`Integrating ${pc.cyan(cms)}...`).start();
 
 			try {
 				const { injectIntegration, formatMergeResults } = await import(
-					"../mergers/index.js"
+					"../../../create-basement-app/src/mergers/index.js"
 				);
 				const results = await injectIntegration(
 					targetDir,
@@ -222,61 +210,70 @@ export async function createProject(projectName, options = {}) {
 			pkg.name = name;
 			pkg.version = "0.1.0";
 
-			// Inject Layer Dependencies from LAYER_CONFIG
-			const layerConfig = getLayerConfig(type);
-			if (layerConfig) {
+			// Layer deps are already in the standalone template's package.json — no injection needed
+
+			// Inject CMS Dependencies from integration config manifests
+			const cmsConfigs = { sanity: sanityConfig };
+			const cmsIntegrationConfig = cmsConfigs[cms];
+			if (cmsIntegrationConfig) {
 				pkg.dependencies = {
 					...pkg.dependencies,
-					...layerConfig.dependencies,
-				};
-				pkg.devDependencies = {
-					...pkg.devDependencies,
-					...layerConfig.devDependencies,
+					...cmsIntegrationConfig.dependencies,
 				};
+				if (
+					cmsIntegrationConfig.devDependencies &&
+					Object.keys(cmsIntegrationConfig.devDependencies).length > 0
+				) {
+					pkg.devDependencies = {
+						...pkg.devDependencies,
+						...cmsIntegrationConfig.devDependencies,
+					};
+				}
+				if (
+					cmsIntegrationConfig.scripts &&
+					Object.keys(cmsIntegrationConfig.scripts).length > 0
+				) {
+					pkg.scripts = {
+						...pkg.scripts,
+						...cmsIntegrationConfig.scripts,
+					};
+				}
 			}
 
-			// Inject CMS Dependencies
-			if (cms === "sanity") {
+			// Inject Animation Dependencies from config manifest
+			const animationConfig = getAnimationConfig(animation);
+			if (animationConfig) {
 				pkg.dependencies = {
 					...pkg.dependencies,
-					"@sanity/asset-utils": "^2.3.0",
-					"@sanity/image-url": "^2.0.3",
-					"@sanity/visual-editing": "^5.1.1",
-					"@sanity/vision": "^5.7.0",
-					"next-sanity": "^12.0.14",
-				};
-
-				pkg.devDependencies = {
-					...pkg.devDependencies,
-					sanity: "^5.6.0",
-				};
-
-				pkg.scripts = {
-					...pkg.scripts,
-					"sanity:extract":
-						"cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity schema extract",
-					"sanity:typegen":
-						"cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity typegen generate && bun biome check --write --unsafe",
-				};
-			} else if (cms === "basehub") {
-				pkg.dependencies = {
-					...pkg.dependencies,
-					basehub: "^3.0.0",
+					...animationConfig.dependencies,
 				};
 			}
 
-			// Inject Animation Dependencies
-			if (animation === "gsap") {
-				pkg.dependencies = {
-					...pkg.dependencies,
-					gsap: "^3.12.0",
-					"@gsap/react": "^2.0.0",
-				};
-			} else if (animation === "motion") {
-				pkg.dependencies = {
-					...pkg.dependencies,
-					motion: "^12.0.0",
-				};
+			// Inject Hook Dependencies from config manifest
+			if (hooks && hooks.length > 0) {
+				for (const hookFile of hooks) {
+					const hookConfig = hooksConfig.find((h) => h.file === hookFile);
+					if (hookConfig) {
+						if (
+							hookConfig.dependencies &&
+							Object.keys(hookConfig.dependencies).length > 0
+						) {
+							pkg.dependencies = {
+								...pkg.dependencies,
+								...hookConfig.dependencies,
+							};
+						}
+						if (
+							hookConfig.devDependencies &&
+							Object.keys(hookConfig.devDependencies).length > 0
+						) {
+							pkg.devDependencies = {
+								...pkg.devDependencies,
+								...hookConfig.devDependencies,
+							};
+						}
+					}
+				}
 			}
 
 			await fs.writeJson(finalPkgPath, pkg, { spaces: 2 });
@@ -371,14 +368,12 @@ export async function createProject(projectName, options = {}) {
 			const projectHooksPath = path.join(targetDir, "hooks");
 			await fs.ensureDir(projectHooksPath);
 
+			const hooksSourceDir = path.resolve(
+				__dirname,
+				"../../../create-basement-app/template-hooks",
+			);
 			for (const hookFile of hooks) {
-				const sourcePath = path.join(
-					__dirname,
-					"..",
-					"..",
-					"template-hooks",
-					hookFile,
-				);
+				const sourcePath = path.join(hooksSourceDir, hookFile);
 				await fs.copy(sourcePath, path.join(projectHooksPath, hookFile));
 			}
 			hooksSpinner.succeed(pc.green(`${hooks.length} hooks added.`));
@@ -404,12 +399,11 @@ export async function createProject(projectName, options = {}) {
 
 		console.log(pc.cyan(`  bun dev\n`));
 	} catch (error) {
-		downloadSpinner.fail(pc.red("Failed to create project."));
+		copySpinner.fail(pc.red("Failed to create project."));
 		console.error(pc.dim(`\nError details: ${error.message}`));
 		console.log(pc.yellow("\n💡 Troubleshooting:"));
-		console.log(`1. Ensure you have a stable internet connection.`);
-		console.log(`2. Verify the repo exists: basementstudio/next-starter`);
-		console.log(`3. Branch "main" must exist in the repository.`);
+		console.log(`1. Verify the template exists: ${templateDir}`);
+		console.log(`2. Check file permissions on the target directory.`);
 		process.exit(1);
 	}
 }

package/packages/create-basement-app/integrations/sanity/config.js

@@ -0,0 +1,46 @@
+// packages/create-basement-app/integrations/sanity/config.js
+
+/**
+ * Sanity integration configuration manifest.
+ * Single source of truth for dependencies, scripts, paths, and merge rules.
+ */
+export const sanityConfig = {
+	name: "sanity",
+
+	dependencies: {
+		"@sanity/asset-utils": "^2.3.0",
+		"@sanity/image-url": "^2.0.3",
+		"@sanity/visual-editing": "^5.1.1",
+		"@sanity/vision": "^5.7.0",
+		"next-sanity": "^12.0.14",
+	},
+
+	devDependencies: {
+		sanity: "^5.6.0",
+	},
+
+	scripts: {
+		"sanity:extract":
+			"cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity schema extract",
+		"sanity:typegen":
+			"cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity typegen generate && bun biome check --write --unsafe",
+	},
+
+	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",
+	],
+
+	mergeFiles: [
+		"app/layout.tsx",
+		"app/sitemap.ts",
+		"lib/integrations/check-integration.ts",
+	],
+};

package/{src → packages/create-basement-app/integrations/sanity}/mergers/check-integration-merger.js

@@ -1,4 +1,4 @@
-// src/mergers/check-integration-merger.js
+// packages/create-basement-app/src/mergers/check-integration-merger.js
 import fs from "fs-extra";
 
 /**

package/{src → packages/create-basement-app/integrations/sanity}/mergers/layout-merger.js

@@ -1,4 +1,4 @@
-// src/mergers/layout-merger.js
+// packages/create-basement-app/src/mergers/layout-merger.js
 
 import path from "node:path";
 import fs from "fs-extra";

package/{src → packages/create-basement-app/integrations/sanity}/mergers/sitemap-merger.js

@@ -1,4 +1,4 @@
-// src/mergers/sitemap-merger.js
+// packages/create-basement-app/src/mergers/sitemap-merger.js
 import fs from "fs-extra";
 
 /**

package/packages/create-basement-app/package.json

@@ -0,0 +1,10 @@
+{
+	"name": "@basementstudio/create-basement-app",
+	"version": "0.1.0",
+	"description": "Template scaffolding and merge logic for basement projects",
+	"type": "module",
+	"main": "src/index.js",
+	"dependencies": {
+		"fs-extra": "^11.3.3"
+	}
+}

package/packages/create-basement-app/src/configs/animations.js

@@ -0,0 +1,28 @@
+// packages/create-basement-app/src/configs/animations.js
+
+/**
+ * Animation library configuration manifest.
+ * Single source of truth for animation library dependencies.
+ */
+export const ANIMATION_CONFIG = {
+	gsap: {
+		dependencies: {
+			gsap: "^3.12.0",
+			"@gsap/react": "^2.0.0",
+		},
+	},
+	motion: {
+		dependencies: {
+			motion: "^12.0.0",
+		},
+	},
+};
+
+/**
+ * Get configuration for a specific animation library
+ * @param {string} name - The animation library name (e.g., 'gsap', 'motion')
+ * @returns {object|null} Animation configuration or null if not found
+ */
+export function getAnimationConfig(name) {
+	return ANIMATION_CONFIG[name] || null;
+}

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

@@ -0,0 +1,15 @@
+// packages/create-basement-app/src/index.js
+
+export { ANIMATION_CONFIG, getAnimationConfig } from "./configs/animations.js";
+export {
+	CMS_CONFIG,
+	getCmsConfig,
+	getLayerConfig,
+	isCmsSupported,
+	LAYER_CONFIG,
+} from "./mergers/config.js";
+export {
+	formatMergeResults,
+	injectIntegration,
+	injectLayer,
+} from "./mergers/index.js";

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

@@ -0,0 +1,105 @@
+// packages/create-basement-app/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 → packages/create-basement-app/src}/mergers/config.js

@@ -1,4 +1,4 @@
-// src/mergers/config.js
+// packages/create-basement-app/src/mergers/config.js
 
 /**
  * CMS-specific configuration for smart merge integration
@@ -6,9 +6,6 @@
  */
 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",
@@ -29,22 +26,11 @@ export const CMS_CONFIG = {
 			"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')
+ * @param {string} cms - The CMS name (e.g., 'sanity')
  * @returns {object|null} CMS configuration or null if not supported
  */
 export function getCmsConfig(cms) {
@@ -71,35 +57,21 @@ export function isCmsSupported(cms) {
  * 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": "^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",
+			leva: "^0.9.35",
 		},
 		devDependencies: {
 			"@types/three": "^0.182.0",