@stdout-design/cli 0.2.3 → 0.2.5

package/dist/index.mjs

@@ -4,10 +4,11 @@ import { Command } from "commander";
 import { AppError, ErrorCode, importTemplateForBatch, loadConfig, openCache, runBatch, zodToJsonSchemaShape } from "@stdout-design/core";
 import path from "node:path";
 import { execSync, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { resolveCommand } from "package-manager-detector/commands";
 import { detect } from "package-manager-detector/detect";
 import { cp, mkdir, writeFile } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
 //#region src/lib/display.ts
 const formatBytes = (bytes) => {
 	if (bytes < 1024) return `${bytes} B`;
@@ -3221,6 +3222,24 @@ const getScaffoldVersion = () => {
 };
 //#endregion
 //#region src/commands/init/scaffold.ts
+const getDefaults = () => ({
+	defaultPreset: "instagram-square",
+	presets: [{
+		height: 1080,
+		id: "instagram-square",
+		platform: "instagram",
+		width: 1080
+	}, {
+		height: 1200,
+		id: "x-card",
+		platform: "x",
+		width: 1200
+	}],
+	templates: { "bento-feature": {
+		componentPath: "./templates/bento-feature",
+		description: "Apple-style bento feature card."
+	} }
+});
 const getConfigTemplate = (version) => `import type { StudioConfig } from "@stdout-design/cli";
 
 const config: StudioConfig = {
@@ -3505,6 +3524,146 @@ const render = async (templateId, propArgs, options) => {
 	if (manifest.failed.length > 0) process.exit(1);
 };
 //#endregion
+//#region src/commands/init/deps.ts
+const updatePackageJsonDeps = (contents, currentVersion) => {
+	const pkg = JSON.parse(contents);
+	const deps = pkg.dependencies ??= {};
+	const currentRange = `^${currentVersion}`;
+	if (deps["@stdout-design/cli"] === currentRange) return {
+		changed: false,
+		updated: contents
+	};
+	deps["@stdout-design/cli"] = currentRange;
+	return {
+		changed: true,
+		updated: JSON.stringify(pkg, null, 2)
+	};
+};
+//#endregion
+//#region src/commands/init/merge-config.ts
+const mergePresets = (existing, defaults, deprecatedPresetIds) => {
+	const existingIds = new Set(existing.presets.map((p) => p.id));
+	const addedPresets = [];
+	const presets = [...existing.presets];
+	for (const defaultPreset of defaults.presets) if (!existingIds.has(defaultPreset.id)) {
+		const marked = deprecatedPresetIds.has(defaultPreset.id) ? {
+			...defaultPreset,
+			deprecated: true
+		} : { ...defaultPreset };
+		presets.push(marked);
+		addedPresets.push(defaultPreset.id);
+	}
+	const presetsWithDeprecation = presets.map((p) => deprecatedPresetIds.has(p.id) && !p.deprecated ? {
+		...p,
+		deprecated: true
+	} : p);
+	return {
+		addedPresets,
+		deprecatedPresets: [...new Set(presetsWithDeprecation.filter((p) => p.deprecated).map((p) => p.id))],
+		presets: presetsWithDeprecation
+	};
+};
+const mergeTemplates = (existing, defaults) => {
+	const addedTemplates = [];
+	const templates = { ...existing.templates };
+	for (const [key, template] of Object.entries(defaults.templates)) if (!(key in templates)) {
+		templates[key] = { ...template };
+		addedTemplates.push(key);
+	}
+	return {
+		addedTemplates,
+		templates
+	};
+};
+const resolveDefaultPreset = (presets, existing, defaults) => {
+	const mergedIds = new Set(presets.map((p) => p.id));
+	const current = existing.defaultPreset;
+	if (current && mergedIds.has(current)) return current;
+	return defaults.defaultPreset ?? defaults.presets[0]?.id;
+};
+const mergeConfig = (existing, defaults, currentVersion, deprecatedPresetIds) => {
+	const oldVersion = existing.scaffoldVersion ?? null;
+	const { presets, addedPresets, deprecatedPresets } = mergePresets(existing, defaults, deprecatedPresetIds);
+	const { templates, addedTemplates } = mergeTemplates(existing, defaults);
+	return {
+		config: {
+			...existing,
+			defaultPreset: resolveDefaultPreset(presets, existing, defaults),
+			presets,
+			scaffoldVersion: currentVersion,
+			templates
+		},
+		summary: {
+			addedPresets,
+			addedTemplates,
+			deprecatedPresets,
+			newVersion: currentVersion,
+			oldVersion
+		}
+	};
+};
+//#endregion
+//#region src/commands/update.ts
+const DEPRECATED_PRESET_IDS = /* @__PURE__ */ new Set();
+const serializeConfig = (config) => `import type { StudioConfig } from "@stdout-design/cli";
+
+const config: StudioConfig = ${JSON.stringify(config, null, 2)};
+
+export default config;
+`;
+const update = async (projectDir, options) => {
+	const cwd = process.cwd();
+	const dir = path.resolve(cwd, projectDir ?? ".");
+	const configPath = path.resolve(dir, "studio.config.ts");
+	if (!existsSync(configPath)) throw new Error("No studio project found. Run `studio init` first.");
+	const existingModule = await import(pathToFileURL(configPath).href);
+	const existing = existingModule.default ?? existingModule;
+	const existingConfig = {
+		defaultPreset: existing.defaultPreset,
+		outDir: existing.outDir,
+		presets: existing.presets ?? [],
+		scaffoldVersion: existing.scaffoldVersion,
+		templates: existing.templates ?? {}
+	};
+	const defaults = getDefaults();
+	const currentVersion = getScaffoldVersion();
+	const { config: merged, summary } = mergeConfig(existingConfig, defaults, currentVersion, DEPRECATED_PRESET_IDS);
+	const { intro, outro, confirm } = await import("@clack/prompts");
+	intro("studio update");
+	if (!(summary.addedPresets.length > 0 || summary.deprecatedPresets.length > 0 || summary.addedTemplates.length > 0 || summary.oldVersion !== summary.newVersion)) {
+		console.log("Project is already up to date.");
+		outro("Done");
+		return;
+	}
+	console.log("");
+	if (summary.oldVersion !== summary.newVersion) console.log(`  scaffoldVersion  ${summary.oldVersion ?? "(none)"} -> ${summary.newVersion}`);
+	for (const id of summary.addedPresets) console.log(`  presets          +${id}`);
+	for (const id of summary.deprecatedPresets) console.log(`  presets          ! ${id} (deprecated)`);
+	for (const id of summary.addedTemplates) console.log(`  templates        +${id}`);
+	console.log("  assets           tsconfig.json, .gitignore, types.d.ts (overwrite)");
+	console.log(`  deps             @stdout-design/cli ^x -> ^${currentVersion}`);
+	console.log("");
+	if (!options?.yes) {
+		if (!await confirm({
+			initialValue: true,
+			message: "Apply these changes?"
+		})) {
+			console.log("Cancelled.");
+			outro("Done");
+			return;
+		}
+	}
+	await writeFile(configPath, serializeConfig(merged));
+	await copyStaticAssets(dir);
+	const pkgPath = path.resolve(dir, "package.json");
+	if (existsSync(pkgPath)) {
+		const { updated, changed } = updatePackageJsonDeps(readFileSync(pkgPath, "utf-8"), currentVersion);
+		if (changed) await writeFile(pkgPath, updated);
+	}
+	console.log("");
+	outro("Done");
+};
+//#endregion
 //#region src/lib/runner.ts
 const handlers = {
 	cache: cacheStats,
@@ -3513,7 +3672,8 @@ const handlers = {
 	dev,
 	init,
 	lint,
-	render
+	render,
+	update
 };
 const run = (moduleName, handlerName) => async (...args) => {
 	try {
@@ -3527,8 +3687,9 @@ const run = (moduleName, handlerName) => async (...args) => {
 };
 //#endregion
 //#region src/index.ts
+const pkg = createRequire(import.meta.url)("../package.json");
 const program = new Command().allowExcessArguments(true);
-program.name("studio").description("Social media design tool — render, preview, batch").version("0.0.0");
+program.name("studio").description("Social media design tool — render, preview, batch").version(pkg.version, "-v, -V, --version");
 program.command("dev").description("Start the studio dev server with live preview").argument("[rootDir]", "Project root directory (default: cwd)").option("-p, --port <number>", "Port to run on", "3000").option("--open", "Open browser on start").action(run("dev"));
 program.command("render").description("Render a template — single or batch with --data").argument("<template>", "Template ID from studio.config.ts").argument("[props...]", "Props as key=value pairs (e.g. title=\"Hello\")").option("--data <path>", "CSV or JSON data file for batch rendering").option("--preset <ids>", "Comma-separated preset IDs").option("--locale <locales>", "Comma-separated locale codes").option("--out-dir <path>", "Output directory").option("--concurrency <n>", "Max concurrent renders in batch mode", "4").option("--fail-fast", "Stop batch on first error").option("--json", "Output results as JSON").action(run("render"));
 const cacheCmd = program.command("cache").description("Manage the render cache");
@@ -3536,6 +3697,7 @@ cacheCmd.command("stats").description("Show cache statistics").option("--json",
 cacheCmd.command("clean").description("Clear the render cache").option("--json", "Output as JSON").argument("[rootDir]", "Project root directory (default: cwd)").action(run("cache", "cacheClean"));
 program.command("lint").description("Check templates for compatibility (coming soon)").argument("[rootDir]", "Project root directory (default: cwd)").action(run("lint"));
 program.command("init").description("Scaffold a new studio project").argument("[projectDir]", "Project directory (default: cwd)").option("-y, --yes", "Skip prompts, use defaults").action(run("init"));
+program.command("update").description("Update an existing studio project to the latest CLI version").argument("[projectDir]", "Project directory (default: cwd)").option("-y, --yes", "Skip confirmation prompts").action(run("update"));
 program.parse();
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdout-design/cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "stdout-design CLI — shallow front door to @stdout-design/core and @stdout-design/dev-server",
   "keywords": [
     "cli",
@@ -62,7 +62,7 @@
     "package-manager-detector": "^1.8.0"
   },
   "devDependencies": {
-    "@stdout-design/config": "0.0.0",
+    "@stdout-design/config": "workspace:*",
     "tsdown": "^0.22.5",
     "typescript": "^7.0.2"
   },