@percepta/create 3.5.1 → 3.6.0

package/dist/index.js

@@ -77,6 +77,17 @@ async function copyTemplate(targetDir, templateType) {
 	}
 }
 //#endregion
+//#region src/utils/design-theme.ts
+const VALID_MOSAIC_DESIGN_THEMES = [
+	"paper",
+	"modern",
+	"dense"
+];
+const DEFAULT_MOSAIC_DESIGN_THEME = "modern";
+function isValidMosaicDesignTheme(value) {
+	return typeof value === "string" && VALID_MOSAIC_DESIGN_THEMES.includes(value);
+}
+//#endregion
 //#region src/utils/detect-monorepo.ts
 const NOT_FOUND = {
 	found: false,
@@ -172,7 +183,7 @@ async function writeManifest(dir, manifest) {
 async function manifestExists(dir) {
 	return fs.pathExists(getManifestPath(dir));
 }
-function derivePlaceholders(appName, appTitle, repoName = appName) {
+function derivePlaceholders(appName, appTitle, repoName = appName, designTheme = DEFAULT_MOSAIC_DESIGN_THEME) {
 	const nameSnake = appName.replace(/-/g, "_");
 	const repoNameSnake = repoName.replace(/-/g, "_");
 	return {
@@ -182,7 +193,8 @@ function derivePlaceholders(appName, appTitle, repoName = appName) {
 		__APP_NAME_UPPER__: appName.toUpperCase(),
 		__APP_NAME_SNAKE__: nameSnake,
 		__REPO_NAME__: repoName,
-		__REPO_NAME_SNAKE__: repoNameSnake
+		__REPO_NAME_SNAKE__: repoNameSnake,
+		__MOSAIC_DESIGN_THEME__: designTheme
 	};
 }
 function resolveMosaicTemplatePath(options) {
@@ -241,6 +253,25 @@ async function promptName(message) {
 	}]);
 	return name;
 }
+async function promptDesignTheme() {
+	const { designTheme } = await inquirer.prompt([{
+		type: "rawlist",
+		name: "designTheme",
+		message: "Design theme?",
+		default: DEFAULT_MOSAIC_DESIGN_THEME,
+		choices: VALID_MOSAIC_DESIGN_THEMES.map((theme) => ({
+			name: theme,
+			value: theme
+		}))
+	}]);
+	return designTheme;
+}
+async function resolveDesignTheme(projectType, defaults) {
+	if (projectType !== "webapp") return void 0;
+	if (defaults.designTheme) return defaults.designTheme;
+	if (defaults.projectType && defaults.name) return DEFAULT_MOSAIC_DESIGN_THEME;
+	return promptDesignTheme();
+}
 /**
 * Outside a monorepo we collect the repo name first, then ask a single
 * "is it a webapp?" Y/n. Yes (default) → monorepo + webapp, no → bare
@@ -308,6 +339,7 @@ async function promptProjectDetails(defaults) {
 		}
 		const packageNamePrompt = projectType === "webapp" ? "Webapp name?" : "Library name?";
 		finalName = defaults.name || await promptName(packageNamePrompt);
+		const designTheme = await resolveDesignTheme(projectType, defaults);
 		const finalTitle = toTitleCase(finalName);
 		const finalDirectory = path.resolve(cwd, repoName);
 		return {
@@ -316,18 +348,21 @@ async function promptProjectDetails(defaults) {
 			name: finalName,
 			title: finalTitle,
 			installDeps: !defaults.skipInstall,
+			designTheme,
 			monorepoName: repoName,
 			monorepoTitle: repoTitle
 		};
 	}
 	const finalTitle = finalName ? toTitleCase(finalName) : "";
+	const designTheme = await resolveDesignTheme(projectType, defaults);
 	const finalDirectory = !inMonorepo && finalName ? path.resolve(cwd, finalName) : "";
 	return {
 		projectType,
 		directory: finalDirectory,
 		name: finalName,
 		title: finalTitle,
-		installDeps: !defaults.skipInstall
+		installDeps: !defaults.skipInstall,
+		designTheme
 	};
 }
 //#endregion
@@ -371,7 +406,8 @@ const PLACEHOLDERS = {
 	__REPO_NAME__: "repoName",
 	__REPO_NAME_SNAKE__: "repoNameSnake",
 	__CREATE_PACKAGE__: "createPackage",
-	__CREATE_VERSION__: "createVersion"
+	__CREATE_VERSION__: "createVersion",
+	__MOSAIC_DESIGN_THEME__: "designTheme"
 };
 const SKIP_DIRS = new Set([
 	"node_modules",
@@ -722,13 +758,13 @@ async function writeMosaicFiles(packageDir, config, projectType, templateVersion
 		templateVersion,
 		templateCommit,
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-		placeholders: derivePlaceholders(config.name, config.title, config.repoName),
+		placeholders: derivePlaceholders(config.name, config.title, config.repoName, config.designTheme),
 		source: { templatePath: `packages/blueberry/templates/${projectType}` }
 	});
 	const notesPath = path.join(packageDir, "mosaic-template-notes.md");
 	await fs.writeFile(notesPath, `# Mosaic Divergence Notes\n\nDocument intentional differences from the ${projectType} template here.\nClaude reads this file during sync to preserve your customizations.\n\n## Intentional Divergences\n\n_None yet — freshly created from template._\n`);
 }
-function buildAppConfig(name, title = toTitleCase(name), repoName = name) {
+function buildAppConfig(name, title = toTitleCase(name), repoName = name, designTheme = DEFAULT_MOSAIC_DESIGN_THEME) {
 	const createPackage = readCreatePackageMetadata();
 	return {
 		name,
@@ -739,7 +775,8 @@ function buildAppConfig(name, title = toTitleCase(name), repoName = name) {
 		repoName,
 		repoNameSnake: toSnakeCase(repoName),
 		createPackage: createPackage.name,
-		createVersion: createPackage.version
+		createVersion: createPackage.version,
+		designTheme
 	};
 }
 /** Copy the monorepo template into `targetDir` and replace its placeholders. */
@@ -890,6 +927,10 @@ async function createProject(options) {
 		console.error(chalk.red(`Error: Invalid package type "${options.type}". Valid types are: ${VALID_PROJECT_TYPES.join(", ")}`));
 		process.exit(1);
 	}
+	if (options.theme !== void 0 && !isValidMosaicDesignTheme(options.theme)) {
+		console.error(chalk.red(`Error: Invalid design theme "${options.theme}". Valid themes are: ${VALID_MOSAIC_DESIGN_THEMES.join(", ")}`));
+		process.exit(1);
+	}
 	console.log();
 	console.log(chalk.bold("Creating a new Mosaic package..."));
 	console.log();
@@ -946,6 +987,7 @@ async function createProject(options) {
 			name: kebabName,
 			title: toTitleCase(kebabName),
 			installDeps: !options.skipInstall,
+			designTheme: projectType === "webapp" ? options.theme ?? "modern" : void 0,
 			monorepoName: monorepoContext.found ? void 0 : kebabRepoName,
 			monorepoTitle: monorepoContext.found ? void 0 : toTitleCase(kebabRepoName)
 		};
@@ -953,6 +995,7 @@ async function createProject(options) {
 		answers = await promptProjectDetails({
 			projectType: options.type,
 			name: projectName ? toKebabCase(projectName) : void 0,
+			designTheme: options.theme,
 			repoName: repoName ? toKebabCase(repoName) : void 0,
 			skipInstall: options.skipInstall,
 			monorepoContext,
@@ -967,7 +1010,7 @@ async function createProject(options) {
 	const monorepoName = answers.monorepoName ?? answers.name;
 	const monorepoConfig = buildAppConfig(monorepoName, answers.monorepoTitle ?? toTitleCase(monorepoName));
 	const configRepoName = monorepoContext.found ? path.basename(monorepoContext.rootDir) : monorepoName;
-	const config = buildAppConfig(answers.name, answers.title, configRepoName);
+	const config = buildAppConfig(answers.name, answers.title, configRepoName, answers.designTheme);
 	const typeLabel = getProjectTypeLabel(answers.projectType);
 	if (monorepoContext.found) {
 		const monorepoRoot = monorepoContext.rootDir;
@@ -976,7 +1019,10 @@ async function createProject(options) {
 		console.log(chalk.dim("  Target:"), packageDir);
 		console.log(chalk.dim("  Name:"), config.name);
 		console.log(chalk.dim("  Title:"), config.title);
-		if (answers.projectType === "webapp") console.log(chalk.dim("  Database:"), config.dbName);
+		if (answers.projectType === "webapp") {
+			console.log(chalk.dim("  Database:"), config.dbName);
+			console.log(chalk.dim("  Design theme:"), config.designTheme);
+		}
 		console.log();
 		if (await fs.pathExists(packageDir)) {
 			if ((await fs.readdir(packageDir)).length > 0) {
@@ -1015,7 +1061,10 @@ async function createProject(options) {
 			console.log(chalk.dim("  Package:"), `packages/${answers.name}/`);
 			console.log(chalk.dim("  Name:"), config.name);
 			console.log(chalk.dim("  Title:"), config.title);
-			if (answers.projectType === "webapp") console.log(chalk.dim("  Database:"), config.dbName);
+			if (answers.projectType === "webapp") {
+				console.log(chalk.dim("  Database:"), config.dbName);
+				console.log(chalk.dim("  Design theme:"), config.designTheme);
+			}
 		}
 		console.log();
 		if (await fs.pathExists(monorepoRoot)) {
@@ -1199,8 +1248,8 @@ function printNextStepsExisting(answers, packageDir, installNeeded) {
 //#region src/index.ts
 const packageJson = readCreatePackageMetadata();
 program.name("create").description("Scaffold and manage Mosaic packages").version(packageJson.version);
-program.command("create", { isDefault: true }).description("Scaffold a new Mosaic package").option("-t, --type <type>", "Package type: monorepo, webapp, or library").option("--name <name>", "Package/app name").option("--repo-name <name>", "Repository name when creating a new monorepo").option("--cwd <dir>", "Run create as if started from this directory").option("--skip-install", "Skip dependency installation (also skips the auto-run setup + dev + browser)", false).option("-y, --yes", "Skip all prompts and use defaults", false).action(createProject);
-program.command("add").description("Add a Mosaic package to the current monorepo").argument("[typeOrName]", "Package type (webapp/library) or package name").argument("[name]", "Package/app name").option("-t, --type <type>", "Package type: webapp or library").option("--name <name>", "Package/app name").option("--skip-install", "Skip dependency installation (also skips the auto-run setup + dev + browser)", false).option("-y, --yes", "Skip all prompts and use defaults", false).action(async (typeOrName, name, options) => {
+program.command("create", { isDefault: true }).description("Scaffold a new Mosaic package").option("-t, --type <type>", "Package type: monorepo, webapp, or library").option("--name <name>", "Package/app name").option("--theme <theme>", "Webapp design theme: modern, paper, or dense").option("--repo-name <name>", "Repository name when creating a new monorepo").option("--cwd <dir>", "Run create as if started from this directory").option("--skip-install", "Skip dependency installation (also skips the auto-run setup + dev + browser)", false).option("-y, --yes", "Skip all prompts and use defaults", false).action(createProject);
+program.command("add").description("Add a Mosaic package to the current monorepo").argument("[typeOrName]", "Package type (webapp/library) or package name").argument("[name]", "Package/app name").option("-t, --type <type>", "Package type: webapp or library").option("--name <name>", "Package/app name").option("--theme <theme>", "Webapp design theme: modern, paper, or dense").option("--skip-install", "Skip dependency installation (also skips the auto-run setup + dev + browser)", false).option("-y, --yes", "Skip all prompts and use defaults", false).action(async (typeOrName, name, options) => {
 	let projectType = options.type;
 	let projectName = options.name;
 	if (typeOrName === "webapp" || typeOrName === "library") {