@bamboocss/dev 1.11.1 → 1.11.2

package/dist/cli-main.cjs

@@ -0,0 +1,381 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./chunk-C2EiDwsr.cjs");
+const require_interactive = require("./interactive-D7Vh3spN.cjs");
+let path = require("path");
+let _bamboocss_shared = require("@bamboocss/shared");
+let _bamboocss_config = require("@bamboocss/config");
+let _bamboocss_logger = require("@bamboocss/logger");
+let _bamboocss_node = require("@bamboocss/node");
+let cac = require("cac");
+//#region src/cli-main.ts
+async function main() {
+	const cli = (0, cac.cac)("bamboo");
+	const cwd = process.cwd();
+	cli.command("init", "Initialize the bamboo config file").option("-i, --interactive", "Run in interactive mode", { default: false }).option("-f, --force", "Force overwrite existing config file").option("-p, --postcss", "Emit postcss config file").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--silent", "Suppress all messages except errors").option("--no-gitignore", "Don't update the .gitignore").option("--no-codegen", "Don't run the codegen logic").option("--out-extension <ext>", "The extension of the generated js files (default: 'mjs')").option("--outdir <dir>", "The output directory for the generated files").option("--jsx-framework <framework>", "The jsx framework to use").option("--syntax <syntax>", "The css syntax preference").option("--strict-tokens", "Using strictTokens: true").option("--logfile <file>", "Outputs logs to a file").action(async (initFlags = {}) => {
+		let options = {};
+		if (initFlags.interactive) options = await require_interactive.interactive();
+		const flags = {
+			...initFlags,
+			...options
+		};
+		const { force, postcss, silent, gitignore, outExtension, jsxFramework, config: configPath, syntax } = flags;
+		const cwd = (0, path.resolve)(flags.cwd ?? "");
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		const stream = (0, _bamboocss_node.setLogStream)({
+			cwd,
+			logfile: flags.logfile
+		});
+		_bamboocss_logger.logger.info("cli", `Bamboo v${require_interactive.version}\n`);
+		const done = _bamboocss_logger.logger.time.info("✨ Bamboo initialized");
+		if (postcss) await (0, _bamboocss_node.setupPostcss)(cwd);
+		await (0, _bamboocss_node.setupConfig)(cwd, (0, _bamboocss_shared.compact)({
+			force,
+			outExtension,
+			jsxFramework,
+			syntax,
+			outdir: flags.outdir
+		}));
+		const ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			configPath,
+			config: (0, _bamboocss_shared.compact)({
+				gitignore,
+				outdir: flags.outdir
+			})
+		});
+		if (gitignore) (0, _bamboocss_node.setupGitIgnore)(ctx);
+		if (flags.codegen) {
+			const { msg, box } = await (0, _bamboocss_node.codegen)(ctx);
+			_bamboocss_logger.logger.log(msg + box);
+		} else _bamboocss_logger.logger.log(ctx.initMessage());
+		done();
+		stream.end();
+	});
+	cli.command("codegen", "Generate the bamboo system").option("--silent", "Don't print any logs").option("--clean", "Clean the output directory before generating").option("-c, --config <path>", "Path to bamboo config file").option("-w, --watch", "Watch files and rebuild").option("-p, --poll", "Use polling instead of filesystem events when watching").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--cpu-prof", "Generates a `.cpuprofile` to help debug performance issues").option("--logfile <file>", "Outputs logs to a file").action(async (flags) => {
+		const { silent, clean, config: configPath, watch, poll } = flags;
+		const cwd = (0, path.resolve)(flags.cwd ?? "");
+		const stream = (0, _bamboocss_node.setLogStream)({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await (0, _bamboocss_node.startProfiling)(cwd, "codegen", flags.watch);
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		let ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			config: { clean },
+			configPath
+		});
+		const { msg } = await (0, _bamboocss_node.codegen)(ctx);
+		_bamboocss_logger.logger.log(msg);
+		if (watch) ctx.watchConfig(async () => {
+			const affecteds = await ctx.diff.reloadConfigAndRefreshContext((conf) => {
+				ctx = new _bamboocss_node.BambooContext(conf);
+			});
+			await ctx.hooks["config:change"]?.({
+				config: ctx.config,
+				changes: affecteds
+			});
+			await (0, _bamboocss_node.codegen)(ctx, Array.from(affecteds.artifacts));
+			_bamboocss_logger.logger.info("ctx:updated", "config rebuilt ✅");
+		}, {
+			cwd,
+			poll
+		});
+		else stream.end();
+		stopProfiling();
+	});
+	cli.command("cssgen [globOrType]", "Generate the css from files, or generate the css from the specified type which can be: preflight, tokens, static, global, keyframes").option("--silent", "Don't print any logs").option("-m, --minify", "Minify generated code").option("--clean", "Clean the output before generating").option("-c, --config <path>", "Path to bamboo config file").option("-w, --watch", "Watch files and rebuild").option("--minimal", "Do not include CSS generation for theme tokens, preflight, keyframes, static and global css").option("--lightningcss", "Use `lightningcss` instead of `postcss` for css optimization.").option("--polyfill", "Polyfill CSS @layers at-rules for older browsers.").option("-p, --poll", "Use polling instead of filesystem events when watching").option("-o, --outfile [file]", "Output file for extracted css, default to './styled-system/styles.css'").option("--splitting", "Emit CSS as separate files per layer (reset, global, tokens, utilities) and per recipe").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--cpu-prof", "Generates a `.cpuprofile` to help debug performance issues").option("--logfile <file>", "Outputs logs to a file").action(async (maybeGlob, flags = {}) => {
+		const { silent, config: configPath, outfile, watch, poll, minimal, splitting, ...rest } = flags;
+		const cwd = (0, path.resolve)(flags.cwd ?? "");
+		const stream = (0, _bamboocss_node.setLogStream)({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await (0, _bamboocss_node.startProfiling)(cwd, "cssgen", flags.watch);
+		const cssArtifact = [
+			"preflight",
+			"tokens",
+			"static",
+			"global",
+			"keyframes"
+		].find((type) => type === maybeGlob);
+		const glob = cssArtifact ? void 0 : maybeGlob;
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		let ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			config: {
+				...rest,
+				...glob ? { include: [glob] } : void 0
+			},
+			configPath
+		});
+		const options = {
+			cwd,
+			outfile,
+			type: cssArtifact,
+			minimal,
+			splitting
+		};
+		await (0, _bamboocss_node.cssgen)(ctx, options);
+		if (watch) {
+			ctx.watchConfig(async () => {
+				const affecteds = await ctx.diff.reloadConfigAndRefreshContext((conf) => {
+					ctx = new _bamboocss_node.BambooContext(conf);
+				});
+				await ctx.hooks["config:change"]?.({
+					config: ctx.config,
+					changes: affecteds
+				});
+				await (0, _bamboocss_node.cssgen)(ctx, options);
+				_bamboocss_logger.logger.info("ctx:updated", "config rebuilt ✅");
+			}, {
+				cwd,
+				poll
+			});
+			ctx.watchFiles(async (event, file) => {
+				if (event === "unlink") ctx.project.removeSourceFile(ctx.runtime.path.abs(cwd, file));
+				else if (event === "change") {
+					ctx.project.reloadSourceFile(file);
+					await (0, _bamboocss_node.cssgen)(ctx, options);
+				} else if (event === "add") {
+					ctx.project.createSourceFile(file);
+					await (0, _bamboocss_node.cssgen)(ctx, options);
+				}
+			});
+		} else {
+			stream.end();
+			stopProfiling();
+		}
+	});
+	cli.command("[files]", "Include file glob", { ignoreOptionDefaultValue: true }).option("-o, --outdir <dir>", "Output directory", { default: "styled-system" }).option("-m, --minify", "Minify generated code").option("-w, --watch", "Watch files and rebuild").option("-p, --poll", "Use polling instead of filesystem events when watching").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--preflight", "Enable css reset").option("--silent", "Suppress all messages except errors").option("-e, --exclude <files>", "Exclude files", { default: [] }).option("--clean", "Clean output directory").option("--hash", "Hash the generated classnames to make them shorter").option("--lightningcss", "Use `lightningcss` instead of `postcss` for css optimization.").option("--polyfill", "Polyfill CSS @layers at-rules for older browsers.").option("--emitTokensOnly", "Whether to only emit the `tokens` directory").option("--cpu-prof", "Generates a `.cpuprofile` to help debug performance issues").option("--logfile <file>", "Outputs logs to a file").action(async (files, flags) => {
+		const { config: configPath, silent, ...rest } = flags;
+		const cwd = (0, path.resolve)(flags.cwd ?? "");
+		const stream = (0, _bamboocss_node.setLogStream)({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await (0, _bamboocss_node.startProfiling)(cwd, "cli", flags.watch);
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		await (0, _bamboocss_node.generate)((0, _bamboocss_shared.compact)({
+			include: files,
+			...rest,
+			cwd
+		}), configPath);
+		stopProfiling();
+		if (!flags.watch) stream.end();
+	});
+	cli.command("spec", "Generate spec files for your theme (useful for documentation)").option("--silent", "Don't print any logs").option("--outdir <dir>", "Output directory for spec files").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).action(async (flags) => {
+		const { silent, config: configPath, outdir } = flags;
+		const cwd = (0, path.resolve)(flags.cwd ?? "");
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		await (0, _bamboocss_node.spec)(await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			configPath,
+			config: { cwd }
+		}), { outdir });
+	});
+	cli.command("studio", "Realtime documentation for your design tokens").option("--build", "Build").option("--preview", "Preview").option("--port <port>", "Port").option("--host", "Host").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--outdir <dir>", "Output directory for static files").option("--base <path>", "Base path of project").action(async (flags) => {
+		const { build, preview, port, host, outdir, config, base } = flags;
+		const cwd = (0, path.resolve)(flags.cwd ?? "");
+		const ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			configPath: config
+		});
+		const buildOpts = {
+			configPath: (0, _bamboocss_config.findConfig)({
+				cwd,
+				file: config
+			}),
+			outDir: (0, path.resolve)(outdir || ctx.studio.outdir),
+			port,
+			host,
+			base
+		};
+		let studio;
+		try {
+			const studioPath = require.resolve("@bamboocss/studio", { paths: [cwd] });
+			studio = require(studioPath);
+		} catch (error) {
+			throw new _bamboocss_shared.BambooError("MISSING_STUDIO", "You need to install '@bamboocss/studio' to use this command", { cause: error });
+		}
+		if (preview) await studio.previewStudio(buildOpts);
+		else if (build) await studio.buildStudio(buildOpts);
+		else {
+			await studio.serveStudio(buildOpts);
+			const note = `use ${_bamboocss_logger.colors.reset(_bamboocss_logger.colors.bold("--build"))} to build`;
+			const port = `use ${_bamboocss_logger.colors.reset(_bamboocss_logger.colors.bold("--port"))} for a different port`;
+			_bamboocss_logger.logger.log(_bamboocss_logger.colors.dim(`  ${_bamboocss_logger.colors.green("➜")}  ${_bamboocss_logger.colors.bold("Build")}: ${note}`));
+			_bamboocss_logger.logger.log(_bamboocss_logger.colors.dim(`  ${_bamboocss_logger.colors.green("➜")}  ${_bamboocss_logger.colors.bold("Port")}: ${port}`));
+		}
+	});
+	cli.command("analyze [glob]", "Analyze design token usage in glob").option("--outfile [filepath]", "Output analyze report in JSON").option("--silent", "Don't print any logs").option("--scope <type>", "Select analysis scope (token or recipe)").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).action(async (maybeGlob, flags = {}) => {
+		const { silent, config: configPath, scope } = flags;
+		const tokenScope = scope == null || scope === "token";
+		const recipeScope = scope == null || scope === "recipe";
+		const cwd = (0, path.resolve)(flags.cwd);
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		const ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			config: maybeGlob ? { include: [maybeGlob] } : void 0,
+			configPath
+		});
+		const result = (0, _bamboocss_node.analyze)(ctx);
+		if (flags?.outfile && typeof flags.outfile === "string") {
+			await result.writeReport(flags.outfile);
+			_bamboocss_logger.logger.info("cli", `JSON report saved to ${(0, path.resolve)(flags.outfile)}`);
+			return;
+		}
+		if (tokenScope) if (!ctx.tokens.isEmpty) {
+			const tokenAnalysis = result.getTokenReport();
+			_bamboocss_logger.logger.info("analyze:tokens", `Token usage report 🎨 \n${tokenAnalysis.formatted}`);
+		} else _bamboocss_logger.logger.info("analyze:tokens", "No tokens found");
+		if (recipeScope) if (!ctx.recipes.isEmpty()) {
+			const recipeAnalysis = result.getRecipeReport();
+			_bamboocss_logger.logger.info("analyze:recipes", `Config recipes usage report 🎛️ \n${recipeAnalysis.formatted}`);
+		} else _bamboocss_logger.logger.info("analyze:recipes", "No config recipes found");
+	});
+	cli.command("debug [glob]", "Debug design token extraction & css generated from files in glob").option("--silent", "Don't print any logs").option("--dry", "Output debug files in stdout without writing to disk").option("--outdir [dir]", "Output directory for debug files, default to './styled-system/debug'").option("--only-config", "Should only output the config file, default to 'false'").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--cpu-prof", "Generates a `.cpuprofile` to help debug performance issues").option("--logfile <file>", "Outputs logs to a file").action(async (maybeGlob, flags = {}) => {
+		const { silent, dry = false, outdir: outdirFlag, config: configPath } = flags ?? {};
+		const cwd = (0, path.resolve)(flags.cwd);
+		const stream = (0, _bamboocss_node.setLogStream)({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await (0, _bamboocss_node.startProfiling)(cwd, "debug");
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		const ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			config: maybeGlob ? { include: [maybeGlob] } : void 0,
+			configPath
+		});
+		await (0, _bamboocss_node.debug)(ctx, {
+			outdir: outdirFlag ?? (0, path.join)(...ctx.paths.root, "debug"),
+			dry,
+			onlyConfig: flags.onlyConfig
+		});
+		stopProfiling();
+		stream.end();
+	});
+	cli.command("ship [glob]", "Ship extract result from files in glob").option("--silent", "Don't print any logs").option("--o, --outfile [file]", "Output path for the build info file, default to './styled-system/bamboo.buildinfo.json'").option("-m, --minify", "Minify generated JSON file").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("-w, --watch", "Watch files and rebuild").option("-p, --poll", "Use polling instead of filesystem events when watching").action(async (maybeGlob, flags = {}) => {
+		const { silent, outfile: outfileFlag, minify, config: configPath, watch, poll } = flags;
+		const cwd = (0, path.resolve)(flags.cwd);
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		let ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			config: maybeGlob ? { include: [maybeGlob] } : void 0,
+			configPath
+		});
+		const outfile = outfileFlag ?? (0, path.join)(...ctx.paths.root, "bamboo.buildinfo.json");
+		if (minify) ctx.config.minify = true;
+		await (0, _bamboocss_node.buildInfo)(ctx, outfile);
+		if (watch) {
+			ctx.watchConfig(async () => {
+				const affecteds = await ctx.diff.reloadConfigAndRefreshContext((conf) => {
+					ctx = new _bamboocss_node.BambooContext(conf);
+				});
+				await ctx.hooks["config:change"]?.({
+					config: ctx.config,
+					changes: affecteds
+				});
+				await (0, _bamboocss_node.buildInfo)(ctx, outfile);
+				_bamboocss_logger.logger.info("ctx:updated", "config rebuilt ✅");
+			}, {
+				cwd,
+				poll
+			});
+			ctx.watchFiles(async (event, file) => {
+				if (event === "unlink") ctx.project.removeSourceFile(ctx.runtime.path.abs(cwd, file));
+				else if (event === "change") {
+					ctx.project.reloadSourceFile(file);
+					await (0, _bamboocss_node.buildInfo)(ctx, outfile);
+				} else if (event === "add") {
+					ctx.project.createSourceFile(file);
+					await (0, _bamboocss_node.buildInfo)(ctx, outfile);
+				}
+			});
+		}
+	});
+	cli.command("emit-pkg", "Emit package.json with entrypoints").option("--outdir <dir>", "Output directory", { default: "." }).option("--base <source>", "The base directory of the package.json entrypoints").option("--silent", "Don't print any logs").option("--cwd <cwd>", "Current working directory", { default: cwd }).action(async (flags) => {
+		const { outdir, silent, base } = flags;
+		if (silent) _bamboocss_logger.logger.level = "silent";
+		const cwd = (0, path.resolve)(flags.cwd);
+		const ctx = await (0, _bamboocss_node.loadConfigAndCreateContext)({
+			cwd,
+			config: { cwd }
+		});
+		const pkgPath = (0, path.resolve)(cwd, outdir, "package.json");
+		const exists = ctx.runtime.fs.existsSync(pkgPath);
+		const exports = [];
+		const createDir = (...dir) => {
+			return [
+				".",
+				base,
+				...dir
+			].filter(Boolean).join("/");
+		};
+		const createEntry = (dir) => ({
+			types: ctx.file.extDts(createDir(dir, "index")),
+			require: ctx.file.ext(createDir(dir, "index")),
+			import: ctx.file.ext(createDir(dir, "index"))
+		});
+		exports.push(["./css", createEntry("css")], ["./tokens", createEntry("tokens")], ["./types", createEntry("types")]);
+		if (!ctx.patterns.isEmpty()) exports.push(["./patterns", createEntry("patterns")]);
+		if (!ctx.recipes.isEmpty()) exports.push(["./recipes", createEntry("recipes")]);
+		if (!ctx.patterns.isEmpty()) exports.push(["./jsx", createEntry("jsx")]);
+		if (ctx.config.themes) exports.push(["./themes", createEntry("themes")]);
+		const stylesDir = createDir("styles.css");
+		if (!exists) {
+			const content = {
+				name: outdir,
+				description: "This package is auto-generated by Bamboo CSS",
+				version: "0.1.0",
+				type: "module",
+				keywords: [
+					"bamboocss",
+					"styled-system",
+					"codegen"
+				],
+				license: "ISC",
+				exports: {
+					...Object.fromEntries(exports),
+					"./styles.css": stylesDir
+				},
+				scripts: { prepare: "bamboo codegen --clean" }
+			};
+			await ctx.runtime.fs.writeFile(pkgPath, JSON.stringify(content, null, 2));
+		} else {
+			const content = JSON.parse(ctx.runtime.fs.readFileSync(pkgPath));
+			content.exports = {
+				...content.exports,
+				...Object.fromEntries(exports),
+				"./styles.css": stylesDir
+			};
+			await ctx.runtime.fs.writeFile(pkgPath, JSON.stringify(content, null, 2));
+		}
+		_bamboocss_logger.logger.info("cli", `Emit package.json to ${pkgPath}`);
+	});
+	cli.command("mcp", "Start MCP server for AI assistants").option("-c, --config <path>", "Path to bamboo config file").option("--cwd <cwd>", "Current working directory", { default: cwd }).action(async (mcpFlags) => {
+		const { startMcpServer } = await import("@bamboocss/mcp");
+		await startMcpServer(mcpFlags);
+	});
+	cli.command("init-mcp", "Initialize MCP configuration for AI clients").option("--cwd <cwd>", "Current working directory", { default: cwd }).option("--client <clients>", "AI clients to configure (claude, cursor, vscode, windsurf, codex)").action(async (mcpInitFlags) => {
+		const { initMcpConfig } = await import("@bamboocss/mcp");
+		const resolvedCwd = (0, path.resolve)(mcpInitFlags.cwd ?? cwd);
+		let clients;
+		if (mcpInitFlags.client) clients = (Array.isArray(mcpInitFlags.client) ? mcpInitFlags.client : [mcpInitFlags.client]).flatMap((c) => c.split(",")).map((c) => c.trim());
+		await initMcpConfig({
+			cwd: resolvedCwd,
+			clients
+		});
+	});
+	cli.help();
+	cli.version(require_interactive.version);
+	cli.parse(process.argv, { run: false });
+	await cli.runMatchedCommand();
+}
+//#endregion
+exports.main = main;

package/dist/cli-main.d.cts

@@ -0,0 +1,4 @@
+//#region src/cli-main.d.ts
+declare function main(): Promise<void>;
+//#endregion
+export { main };

package/dist/cli-main.d.mts

@@ -0,0 +1,4 @@
+//#region src/cli-main.d.ts
+declare function main(): Promise<void>;
+//#endregion
+export { main };