@bamboocss/dev 1.11.3 → 1.12.0

package/dist/cli-default.mjs

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
-import { a as __toESM, i as __require, n as __commonJSMin, r as __esmMin, t as main } from "./cli-main-DdGGICwA.mjs";
-import { t as handleError } from "./errors-DyRfueHt.mjs";
-import { n as name, r as version } from "./interactive-D22006je.mjs";
+import { createRequire } from "node:module";
 import process$1, { env } from "node:process";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
@@ -9,9 +7,41 @@ import path from "node:path";
 import { format, promisify } from "node:util";
 import os from "node:os";
 import os$1 from "os";
-import path$1 from "path";
+import path$1, { join, resolve } from "path";
 import fs from "node:fs";
 import tty from "node:tty";
+import { isMainThread, parentPort } from "worker_threads";
+import { BambooError, compact } from "@bamboocss/shared";
+import { findConfig } from "@bamboocss/config";
+import { colors, logger } from "@bamboocss/logger";
+import { BambooContext, analyze, buildInfo, codegen, cssgen, debug, generate, loadConfigAndCreateContext, setLogStream, setupConfig, setupGitIgnore, setupPostcss, spec, startProfiling } from "@bamboocss/node";
+import { cac } from "cac";
+import * as p from "@clack/prompts";
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
 //#region ../../node_modules/.pnpm/graceful-fs@4.2.11/node_modules/graceful-fs/polyfills.js
 var require_polyfills$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	var constants$1 = __require("constants");
@@ -7483,6 +7513,605 @@ function updateNotifier(options) {
 	return updateNotifier;
 }
 //#endregion
+//#region ../../node_modules/.pnpm/kleur@4.1.5/node_modules/kleur/index.mjs
+let FORCE_COLOR, NODE_DISABLE_COLORS, NO_COLOR, TERM, isTTY = true;
+if (typeof process !== "undefined") {
+	({FORCE_COLOR, NODE_DISABLE_COLORS, NO_COLOR, TERM} = process.env || {});
+	isTTY = process.stdout && process.stdout.isTTY;
+}
+const $ = {
+	enabled: !NODE_DISABLE_COLORS && NO_COLOR == null && TERM !== "dumb" && (FORCE_COLOR != null && FORCE_COLOR !== "0" || isTTY),
+	reset: init(0, 0),
+	bold: init(1, 22),
+	dim: init(2, 22),
+	italic: init(3, 23),
+	underline: init(4, 24),
+	inverse: init(7, 27),
+	hidden: init(8, 28),
+	strikethrough: init(9, 29),
+	black: init(30, 39),
+	red: init(31, 39),
+	green: init(32, 39),
+	yellow: init(33, 39),
+	blue: init(34, 39),
+	magenta: init(35, 39),
+	cyan: init(36, 39),
+	white: init(37, 39),
+	gray: init(90, 39),
+	grey: init(90, 39),
+	bgBlack: init(40, 49),
+	bgRed: init(41, 49),
+	bgGreen: init(42, 49),
+	bgYellow: init(43, 49),
+	bgBlue: init(44, 49),
+	bgMagenta: init(45, 49),
+	bgCyan: init(46, 49),
+	bgWhite: init(47, 49)
+};
+function run(arr, str) {
+	let i = 0, tmp, beg = "", end = "";
+	for (; i < arr.length; i++) {
+		tmp = arr[i];
+		beg += tmp.open;
+		end += tmp.close;
+		if (!!~str.indexOf(tmp.close)) str = str.replace(tmp.rgx, tmp.close + tmp.open);
+	}
+	return beg + str + end;
+}
+function chain(has, keys) {
+	let ctx = {
+		has,
+		keys
+	};
+	ctx.reset = $.reset.bind(ctx);
+	ctx.bold = $.bold.bind(ctx);
+	ctx.dim = $.dim.bind(ctx);
+	ctx.italic = $.italic.bind(ctx);
+	ctx.underline = $.underline.bind(ctx);
+	ctx.inverse = $.inverse.bind(ctx);
+	ctx.hidden = $.hidden.bind(ctx);
+	ctx.strikethrough = $.strikethrough.bind(ctx);
+	ctx.black = $.black.bind(ctx);
+	ctx.red = $.red.bind(ctx);
+	ctx.green = $.green.bind(ctx);
+	ctx.yellow = $.yellow.bind(ctx);
+	ctx.blue = $.blue.bind(ctx);
+	ctx.magenta = $.magenta.bind(ctx);
+	ctx.cyan = $.cyan.bind(ctx);
+	ctx.white = $.white.bind(ctx);
+	ctx.gray = $.gray.bind(ctx);
+	ctx.grey = $.grey.bind(ctx);
+	ctx.bgBlack = $.bgBlack.bind(ctx);
+	ctx.bgRed = $.bgRed.bind(ctx);
+	ctx.bgGreen = $.bgGreen.bind(ctx);
+	ctx.bgYellow = $.bgYellow.bind(ctx);
+	ctx.bgBlue = $.bgBlue.bind(ctx);
+	ctx.bgMagenta = $.bgMagenta.bind(ctx);
+	ctx.bgCyan = $.bgCyan.bind(ctx);
+	ctx.bgWhite = $.bgWhite.bind(ctx);
+	return ctx;
+}
+function init(open, close) {
+	let blk = {
+		open: `\x1b[${open}m`,
+		close: `\x1b[${close}m`,
+		rgx: new RegExp(`\\x1b\\[${close}m`, "g")
+	};
+	return function(txt) {
+		if (this !== void 0 && this.has !== void 0) {
+			~this.has.indexOf(open) || (this.has.push(open), this.keys.push(blk));
+			return txt === void 0 ? this : $.enabled ? run(this.keys, txt + "") : txt + "";
+		}
+		return txt === void 0 ? chain([open], [blk]) : $.enabled ? run([blk], txt + "") : txt + "";
+	};
+}
+//#endregion
+//#region src/errors.ts
+function handleError(error) {
+	if (error instanceof BambooError) {
+		console.error($.red(`${error.code}: ${error.message}`));
+		if (error.hint) console.error($.dim(error.hint));
+		if (error.cause instanceof Error) console.error($.dim(`Caused by: ${error.cause.message}`));
+	} else if (isLocError(error)) {
+		console.error($.bold($.red(`Error parsing: ${error.loc.file}:${error.loc.line}:${error.loc.column}`)));
+		if (error.frame) {
+			console.error($.red(error.message));
+			console.error($.dim(error.frame));
+		} else console.error($.red(error.message));
+	} else {
+		const message = error instanceof Error ? error.message : String(error);
+		console.error($.red(message));
+	}
+	process.exitCode = 1;
+	if (!isMainThread && parentPort) parentPort.postMessage("error");
+}
+function isLocError(error) {
+	return typeof error === "object" && error !== null && "loc" in error && typeof error.loc === "object" && "message" in error;
+}
+//#endregion
+//#region package.json
+var name = "@bamboocss/dev";
+var version = "1.12.0";
+//#endregion
+//#region src/interactive.ts
+const interactive = async () => {
+	p.intro(`bamboo v${version}`);
+	const initFlags = await p.group({
+		usePostcss: () => p.select({
+			message: "Would you like to use PostCSS ?",
+			initialValue: "yes",
+			options: [{
+				value: "yes",
+				label: "Yes"
+			}, {
+				value: "no",
+				label: "No"
+			}]
+		}),
+		useMjsExtension: () => p.select({
+			message: "Use the mjs extension ?",
+			initialValue: "yes",
+			options: [{
+				value: "yes",
+				label: "Yes"
+			}, {
+				value: "no",
+				label: "No"
+			}]
+		}),
+		jsxOptions: () => p.group({
+			styleProps: () => p.select({
+				message: "Would you like to use JSX Style Props ?",
+				initialValue: "yes",
+				options: [{
+					value: "yes",
+					label: "Yes"
+				}, {
+					value: "no",
+					label: "No"
+				}]
+			}),
+			jsxFramework: () => p.select({
+				message: "What JSX framework?",
+				initialValue: "react",
+				options: [
+					{
+						value: "react",
+						label: "React"
+					},
+					{
+						value: "vue",
+						label: "Vue"
+					},
+					{
+						value: "solid",
+						label: "Solid"
+					},
+					{
+						value: "qwik",
+						label: "Qwik"
+					}
+				]
+			})
+		}),
+		whatSyntax: () => p.select({
+			message: "What css syntax would you like to use?",
+			initialValue: "object",
+			options: [{
+				value: "object-literal",
+				label: "Object"
+			}, {
+				value: "template-literal",
+				label: "Template literal"
+			}]
+		}),
+		withStrictTokens: () => p.select({
+			message: "Use strict tokens to enforce full type-safety?",
+			initialValue: "no",
+			options: [{
+				value: "yes",
+				label: "Yes"
+			}, {
+				value: "no",
+				label: "No"
+			}]
+		}),
+		shouldUpdateGitignore: () => p.select({
+			message: "Update gitignore?",
+			initialValue: "yes",
+			options: [{
+				value: "yes",
+				label: "Yes"
+			}, {
+				value: "no",
+				label: "No"
+			}]
+		})
+	}, { onCancel: () => {
+		p.cancel("Operation cancelled.");
+		process.exit(0);
+	} });
+	p.outro("Let's get started! 🐼");
+	return {
+		postcss: initFlags.usePostcss === "yes",
+		outExtension: initFlags.useMjsExtension === "yes" ? "mjs" : "js",
+		jsxFramework: initFlags.jsxOptions.jsxFramework,
+		syntax: initFlags.whatSyntax,
+		strictTokens: initFlags.withStrictTokens === "yes",
+		gitignore: initFlags.shouldUpdateGitignore === "yes"
+	};
+};
+//#endregion
+//#region src/cli-main.ts
+async function main() {
+	const cli = 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 interactive();
+		const flags = {
+			...initFlags,
+			...options
+		};
+		const { force, postcss, silent, gitignore, outExtension, jsxFramework, config: configPath, syntax } = flags;
+		const cwd = resolve(flags.cwd ?? "");
+		if (silent) logger.level = "silent";
+		const stream = setLogStream({
+			cwd,
+			logfile: flags.logfile
+		});
+		logger.info("cli", `Bamboo v${version}\n`);
+		const done = logger.time.info("✨ Bamboo initialized");
+		if (postcss) await setupPostcss(cwd);
+		await setupConfig(cwd, compact({
+			force,
+			outExtension,
+			jsxFramework,
+			syntax,
+			outdir: flags.outdir
+		}));
+		const ctx = await loadConfigAndCreateContext({
+			cwd,
+			configPath,
+			config: compact({
+				gitignore,
+				outdir: flags.outdir
+			})
+		});
+		if (gitignore) setupGitIgnore(ctx);
+		if (flags.codegen) {
+			const { msg, box } = await codegen(ctx);
+			logger.log(msg + box);
+		} else 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 = resolve(flags.cwd ?? "");
+		const stream = setLogStream({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await startProfiling(cwd, "codegen", flags.watch);
+		if (silent) logger.level = "silent";
+		let ctx = await loadConfigAndCreateContext({
+			cwd,
+			config: { clean },
+			configPath
+		});
+		const { msg } = await codegen(ctx);
+		logger.log(msg);
+		if (watch) ctx.watchConfig(async () => {
+			const affecteds = await ctx.diff.reloadConfigAndRefreshContext((conf) => {
+				ctx = new BambooContext(conf);
+			});
+			await ctx.hooks["config:change"]?.({
+				config: ctx.config,
+				changes: affecteds
+			});
+			await codegen(ctx, Array.from(affecteds.artifacts));
+			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 = resolve(flags.cwd ?? "");
+		const stream = setLogStream({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await startProfiling(cwd, "cssgen", flags.watch);
+		const cssArtifact = [
+			"preflight",
+			"tokens",
+			"static",
+			"global",
+			"keyframes"
+		].find((type) => type === maybeGlob);
+		const glob = cssArtifact ? void 0 : maybeGlob;
+		if (silent) logger.level = "silent";
+		let ctx = await loadConfigAndCreateContext({
+			cwd,
+			config: {
+				...rest,
+				...glob ? { include: [glob] } : void 0
+			},
+			configPath
+		});
+		const options = {
+			cwd,
+			outfile,
+			type: cssArtifact,
+			minimal,
+			splitting
+		};
+		await cssgen(ctx, options);
+		if (watch) {
+			ctx.watchConfig(async () => {
+				const affecteds = await ctx.diff.reloadConfigAndRefreshContext((conf) => {
+					ctx = new BambooContext(conf);
+				});
+				await ctx.hooks["config:change"]?.({
+					config: ctx.config,
+					changes: affecteds
+				});
+				await cssgen(ctx, options);
+				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 cssgen(ctx, options);
+				} else if (event === "add") {
+					ctx.project.createSourceFile(file);
+					await 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 = resolve(flags.cwd ?? "");
+		const stream = setLogStream({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await startProfiling(cwd, "cli", flags.watch);
+		if (silent) logger.level = "silent";
+		await generate(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 = resolve(flags.cwd ?? "");
+		if (silent) logger.level = "silent";
+		await spec(await 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 = resolve(flags.cwd ?? "");
+		const ctx = await loadConfigAndCreateContext({
+			cwd,
+			configPath: config
+		});
+		const buildOpts = {
+			configPath: findConfig({
+				cwd,
+				file: config
+			}),
+			outDir: resolve(outdir || ctx.studio.outdir),
+			port,
+			host,
+			base
+		};
+		let studio;
+		try {
+			studio = __require(__require.resolve("@bamboocss/studio", { paths: [cwd] }));
+		} catch (error) {
+			throw new 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 ${colors.reset(colors.bold("--build"))} to build`;
+			const port = `use ${colors.reset(colors.bold("--port"))} for a different port`;
+			logger.log(colors.dim(`  ${colors.green("➜")}  ${colors.bold("Build")}: ${note}`));
+			logger.log(colors.dim(`  ${colors.green("➜")}  ${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 = resolve(flags.cwd);
+		if (silent) logger.level = "silent";
+		const ctx = await loadConfigAndCreateContext({
+			cwd,
+			config: maybeGlob ? { include: [maybeGlob] } : void 0,
+			configPath
+		});
+		const result = analyze(ctx);
+		if (flags?.outfile && typeof flags.outfile === "string") {
+			await result.writeReport(flags.outfile);
+			logger.info("cli", `JSON report saved to ${resolve(flags.outfile)}`);
+			return;
+		}
+		if (tokenScope) if (!ctx.tokens.isEmpty) {
+			const tokenAnalysis = result.getTokenReport();
+			logger.info("analyze:tokens", `Token usage report 🎨 \n${tokenAnalysis.formatted}`);
+		} else logger.info("analyze:tokens", "No tokens found");
+		if (recipeScope) if (!ctx.recipes.isEmpty()) {
+			const recipeAnalysis = result.getRecipeReport();
+			logger.info("analyze:recipes", `Config recipes usage report 🎛️ \n${recipeAnalysis.formatted}`);
+		} else 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 = resolve(flags.cwd);
+		const stream = setLogStream({
+			cwd,
+			logfile: flags.logfile
+		});
+		let stopProfiling = () => void 0;
+		if (flags.cpuProf) stopProfiling = await startProfiling(cwd, "debug");
+		if (silent) logger.level = "silent";
+		const ctx = await loadConfigAndCreateContext({
+			cwd,
+			config: maybeGlob ? { include: [maybeGlob] } : void 0,
+			configPath
+		});
+		await debug(ctx, {
+			outdir: outdirFlag ?? 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 = resolve(flags.cwd);
+		if (silent) logger.level = "silent";
+		let ctx = await loadConfigAndCreateContext({
+			cwd,
+			config: maybeGlob ? { include: [maybeGlob] } : void 0,
+			configPath
+		});
+		const outfile = outfileFlag ?? join(...ctx.paths.root, "bamboo.buildinfo.json");
+		if (minify) ctx.config.minify = true;
+		await buildInfo(ctx, outfile);
+		if (watch) {
+			ctx.watchConfig(async () => {
+				const affecteds = await ctx.diff.reloadConfigAndRefreshContext((conf) => {
+					ctx = new BambooContext(conf);
+				});
+				await ctx.hooks["config:change"]?.({
+					config: ctx.config,
+					changes: affecteds
+				});
+				await buildInfo(ctx, outfile);
+				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 buildInfo(ctx, outfile);
+				} else if (event === "add") {
+					ctx.project.createSourceFile(file);
+					await 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) logger.level = "silent";
+		const cwd = resolve(flags.cwd);
+		const ctx = await loadConfigAndCreateContext({
+			cwd,
+			config: { cwd }
+		});
+		const pkgPath = 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));
+		}
+		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 = 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(version);
+	cli.parse(process.argv, { run: false });
+	await cli.runMatchedCommand();
+}
+//#endregion
 //#region src/cli-default.ts
 updateNotifier({
 	pkg: {