@withstudiocms/buildkit 0.1.0-beta.2 → 0.1.0-beta.4

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# @withstudiocms/buildkit
+
+## 0.1.0-beta.4
+
+### Patch Changes
+
+- [#684](https://github.com/withstudiocms/studiocms/pull/684) [`15e6ee0`](https://github.com/withstudiocms/studiocms/commit/15e6ee0c50e37b22bcb24a0b67403e357e2502db) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - fix: add shebang to builder, help, test, and index scripts for executable compatibility
+
+- [#711](https://github.com/withstudiocms/studiocms/pull/711) [`22d748f`](https://github.com/withstudiocms/studiocms/commit/22d748f445b53bc340aad9a99ac4ebac6b0e9d7c) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Adds copy support for `.stub.js`
+
+- [#680](https://github.com/withstudiocms/studiocms/pull/680) [`9c66603`](https://github.com/withstudiocms/studiocms/commit/9c6660397bc3a8c952713e7587df507b8c6d3d17) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Refactors buildkit to be broken out into individual files to help with maintainability
+
+## 0.1.0-beta.3
+
+### Patch Changes
+
+- [#669](https://github.com/withstudiocms/studiocms/pull/669) [`d757989`](https://github.com/withstudiocms/studiocms/commit/d75798912aaadab3d874c48176f2f9902bfa8502) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Implements node testing system for usage by StudioCMS and related packages
+
+## 0.1.0-beta.2
+
+### Patch Changes
+
+- [#643](https://github.com/withstudiocms/studiocms/pull/643) [`9cfba9a`](https://github.com/withstudiocms/studiocms/commit/9cfba9ad57f8fb1b2a10081fbe5f9dfc26bed57d) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Add font file copy support to build-kit
+
+- [#650](https://github.com/withstudiocms/studiocms/pull/650) [`3e7f7ca`](https://github.com/withstudiocms/studiocms/commit/3e7f7ca6ea2a304fe66eac95496542cc50169eb2) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Update various deps and lint repo with updated biome version
+
+- [#657](https://github.com/withstudiocms/studiocms/pull/657) [`a05bb16`](https://github.com/withstudiocms/studiocms/commit/a05bb16d3dd0d1a429558b4dce316ad7fb80b049) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Update esbuild
+
+- [#648](https://github.com/withstudiocms/studiocms/pull/648) [`e490385`](https://github.com/withstudiocms/studiocms/commit/e490385dbdad5392f23c46a832c8a555dbf48a9a) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Update package.json to conform to new repository structure
+
+## 0.1.0-beta.1
+
+### Patch Changes
+
+- [#520](https://github.com/withstudiocms/studiocms/pull/520) [`940abc0`](https://github.com/withstudiocms/studiocms/commit/940abc014460b6c8cf4c5e9a0291e06a1f416f18) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - add support for additional image file types in asset handling and add README
+
+- [#519](https://github.com/withstudiocms/studiocms/pull/519) [`1f11779`](https://github.com/withstudiocms/studiocms/commit/1f11779078c58cc1fd42f63af6f62d0ae315478a) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - add license
+
+- [#512](https://github.com/withstudiocms/studiocms/pull/512) [`cd10407`](https://github.com/withstudiocms/studiocms/commit/cd1040779926a55db63ceb6ac1b9ddacb23330a8) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Initial release, publish buildkit for usage with other withstudiocms repos
+
+- [#541](https://github.com/withstudiocms/studiocms/pull/541) [`5dea0d4`](https://github.com/withstudiocms/studiocms/commit/5dea0d4419d358b22858ab7455bbbb96f5b01e95) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - fix buildkit help: Show correct command name
+
+- [#540](https://github.com/withstudiocms/studiocms/pull/540) [`ae5c71a`](https://github.com/withstudiocms/studiocms/commit/ae5c71a49a777a2a7d4b322a3cb76978650d53de) Thanks [@dreyfus92](https://github.com/dreyfus92)! - Adds help command to the CLI buildkit.
+
+- [#521](https://github.com/withstudiocms/studiocms/pull/521) [`dec39cc`](https://github.com/withstudiocms/studiocms/commit/dec39cc28fc557586f61472c1bf7953e8bd5c5a0) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Simplify buildkit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withstudiocms/buildkit",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "description": "Build kit based on esbuild for the withstudiocms github org",
   "author": {
     "name": "withstudiocms",
@@ -13,29 +13,29 @@
   },
   "license": "MIT",
   "files": [
-    "index.js",
-    "cmd"
+    "src",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
   ],
   "type": "module",
-  "main": "./index.js",
+  "main": "./src/index.js",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "bin": {
-    "buildkit": "./index.js"
+    "buildkit": "./src/index.js"
   },
   "dependencies": {
     "esbuild": "^0.25.8",
-    "fast-glob": "^3.3.3",
-    "kleur": "^4.1.5"
+    "tinyglobby": "^0.2.14",
+    "chalk": "^5.6.0"
   },
   "devDependencies": {
-    "vitest": "^3.2.4",
     "strip-ansi": "^7.1.0"
   },
   "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "test": "buildkit test 'test/**/*.test.js'"
   }
 }

package/src/cmds/builder.js

@@ -0,0 +1,266 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs/promises';
+import chalk from 'chalk';
+import esbuild from 'esbuild';
+import { glob } from 'tinyglobby';
+
+/** @type {import('esbuild').BuildOptions} */
+const defaultConfig = {
+	minify: false,
+	format: 'esm',
+	platform: 'node',
+	target: 'node18',
+	sourcemap: false,
+	sourcesContent: false,
+	loader: {
+		'.astro': 'copy',
+		'.json': 'copy',
+		'.gif': 'copy',
+		'.jpeg': 'copy',
+		'.jpg': 'copy',
+		'.png': 'copy',
+		'.tiff': 'copy',
+		'.webp': 'copy',
+		'.avif': 'copy',
+		'.svg': 'copy',
+		'.woff2': 'copy',
+		'.woff': 'copy',
+		'.ttf': 'copy',
+		'.eot': 'copy',
+		'.otf': 'copy',
+	},
+};
+
+/**
+ * Plugin to copy *.stub.(js|mjs|cjs) without parsing/bundling.
+ * NOTE: Importing these will yield a file URL string at runtime, not executed JS.
+ * @type {import('esbuild').Plugin} The esbuild plugin for generating TypeScript declarations.
+ */
+const copyStubJsPlugin = {
+	name: 'copy-stub-js',
+	setup(build) {
+		// Match both entry points and imported modules
+		const filter = /\.stub\.(?:js|mjs|cjs)$/;
+		build.onLoad({ filter }, async (args) => {
+			const contents = await fs.readFile(args.path);
+			return { contents, loader: 'copy' };
+		});
+	},
+};
+
+/**
+ * Plugin to copy *.d.ts without parsing/bundling.
+ * NOTE: Importing these will yield a file URL string at runtime, not executed JS.
+ * @type {import('esbuild').Plugin} The esbuild plugin for generating TypeScript declarations.
+ */
+const copyDTSPlugin = {
+	name: 'copy-dts',
+	setup(build) {
+		// Match both entry points and imported modules
+		const filter = /\.d\.ts$/;
+		build.onLoad({ filter }, async (args) => {
+			const contents = await fs.readFile(args.path);
+			return { contents, loader: 'copy' };
+		});
+	},
+};
+
+const copyPlugins = [copyStubJsPlugin, copyDTSPlugin];
+
+// DateTime format for logging
+/**
+ * @type {Intl.DateTimeFormat}
+ */
+const dt = new Intl.DateTimeFormat('en-us', {
+	hour: '2-digit',
+	minute: '2-digit',
+});
+
+/** * Plugin to generate TypeScript declarations using the TypeScript compiler.
+ * @param {string} buildTsConfig - The path to the TypeScript configuration file.
+ * @param {string} outdir - The output directory for the generated declarations.
+ * @returns {import('esbuild').Plugin} The esbuild plugin for generating TypeScript declarations.
+ */
+const dtsGen = (buildTsConfig, outdir) => ({
+	name: 'TypeScriptDeclarationsPlugin',
+	setup(build) {
+		build.onEnd((result) => {
+			if (result.errors.length > 0) return;
+			const date = dt.format(new Date());
+			console.log(`${chalk.dim(`[${date}]`)} Generating TypeScript declarations...`);
+			try {
+				const res = execFileSync(
+					'tsc',
+					['--emitDeclarationOnly', '-p', buildTsConfig, '--outDir', `./${outdir}`],
+					{ encoding: 'utf8' }
+				);
+				if (res) console.log(res);
+				console.log(chalk.dim(`[${date}] `) + chalk.green('√ Generated TypeScript declarations'));
+			} catch (error) {
+				const msg =
+					(error && (error.message || String(error))) +
+					'\n\n' +
+					// stdout/stderr may be Buffer or string depending on exec options
+					(typeof error?.stdout === 'string' ? error.stdout : (error?.stdout?.toString?.() ?? '')) +
+					(typeof error?.stderr === 'string' ? error.stderr : (error?.stderr?.toString?.() ?? ''));
+				console.error(chalk.dim(`[${date}] `) + chalk.red(msg));
+			}
+		});
+	},
+});
+
+/** * Clean the output directory by removing all files except those specified in the skip array.
+ * @param {string} outdir - The output directory to clean.
+ * @param {string} date - The date string for logging.
+ * @param {string[]} skip - An array of glob patterns to skip when cleaning.
+ * @throws {Error} If the glob operation fails or if there are issues removing files.
+ */
+async function clean(outdir, date, skip = []) {
+	const files = await glob([`${outdir}/**`, ...skip], { filesOnly: true });
+	console.log(chalk.dim(`[${date}] `) + chalk.dim(`Cleaning ${files.length} files from ${outdir}`));
+	await Promise.all(files.map((file) => fs.rm(file, { force: true })));
+}
+
+/** * Read and parse the package.json file.
+ * @param {string} path - The path to the package.json file.
+ * @returns {Promise<Object>} The parsed JSON object.
+ * @throws {Error} If the file cannot be read or is not valid JSON.
+ */
+async function readPackageJSON(path) {
+	try {
+		const content = await fs.readFile(path, { encoding: 'utf8' });
+		try {
+			return JSON.parse(content);
+		} catch (parseError) {
+			throw new Error(`Invalid JSON in ${path}: ${parseError.message}`);
+		}
+	} catch (readError) {
+		throw new Error(`Failed to read ${path}: ${readError.message}`);
+	}
+}
+
+/**
+ * Run the dev or build command with the provided arguments.
+ * @param {string} cmd - The command to run ('dev' or 'build').
+ * @param {string[]} args - The arguments to pass to the command.
+ */
+export default async function builder(cmd, args) {
+	const config = Object.assign({}, defaultConfig);
+	const patterns = args
+		.filter((f) => !!f) // remove empty args
+		.map((f) => f.replace(/^'/, '').replace(/'$/, '')); // Needed for Windows: glob strings contain surrounding string chars??? remove these
+
+	/**
+	 * Collect all entry points based on the provided patterns.
+	 * @type {string[]}
+	 */
+	const entryPoints = [].concat(
+		...(await Promise.all(
+			patterns.map((pattern) => glob(pattern, { filesOnly: true, absolute: true }))
+		))
+	);
+
+	if (entryPoints.length === 0) {
+		throw new Error(`No entry points found for pattern(s): ${patterns.join(', ')}`);
+	}
+
+	const date = dt.format(new Date());
+
+	const noClean = args.includes('--no-clean-dist');
+	const bundle = args.includes('--bundle');
+	const forceCJS = args.includes('--force-cjs');
+	const buildTsConfig =
+		args.find((arg) => arg.startsWith('--tsconfig='))?.split('=')[1] || 'tsconfig.json';
+	const outdir = args.find((arg) => arg.startsWith('--outdir='))?.split('=')[1] || 'dist';
+
+	const { type = 'module', dependencies = {} } = await readPackageJSON('./package.json');
+
+	const format = type === 'module' && !forceCJS ? 'esm' : 'cjs';
+
+	switch (cmd) {
+		case 'dev': {
+			if (!noClean) {
+				console.log(
+					`${chalk.dim(`[${date}]`)} Cleaning ${outdir} directory... ${chalk.dim(`(${entryPoints.length} files found)`)}`
+				);
+				await clean(outdir, date, [`!${outdir}/**/*.d.ts`]);
+			}
+
+			/**
+			 * Plugin to handle rebuilds during development.
+			 * It logs the result of the build process and any warnings or errors.
+			 * @type {import('esbuild').Plugin}
+			 * @description This plugin is used to provide feedback during development builds.
+			 */
+			const rebuildPlugin = {
+				name: 'dev:rebuild',
+				setup(build) {
+					build.onEnd(async (result) => {
+						const date = dt.format(new Date());
+						if (result?.errors.length) {
+							const formatted = await esbuild.formatMessages(result.errors, {
+								kind: 'error',
+								color: true,
+							});
+							console.error(chalk.dim(`[${date}] `) + chalk.red(formatted.join('\n')));
+							return;
+						}
+						if (result.warnings.length) {
+							const formattedWarns = await esbuild.formatMessages(result.warnings, {
+								kind: 'warning',
+								color: true,
+							});
+							console.info(
+								chalk.dim(`[${date}] `) +
+									chalk.yellow(`! updated with warnings:\n${formattedWarns.join('\n')}`)
+							);
+						}
+						console.info(chalk.dim(`[${date}] `) + chalk.green('√ updated'));
+					});
+				},
+			};
+
+			const builder = await esbuild.context({
+				...config,
+				entryPoints,
+				outdir,
+				format,
+				sourcemap: 'linked',
+				plugins: [rebuildPlugin, ...copyPlugins],
+			});
+
+			console.log(
+				`${chalk.dim(`[${date}] `) + chalk.gray('Watching for changes...')} ${chalk.dim(`(${entryPoints.length} files found)`)}`
+			);
+			await builder.watch();
+
+			process.on('beforeExit', () => {
+				builder.stop?.();
+			});
+			break;
+		}
+		case 'build': {
+			if (!noClean) {
+				console.log(
+					`${chalk.dim(`[${date}]`)} Cleaning ${outdir} directory... ${chalk.dim(`(${entryPoints.length} files found)`)}`
+				);
+				await clean(outdir, date, [`!${outdir}/**/*.d.ts`]);
+			}
+			console.log(
+				`${chalk.dim(`[${date}]`)} Building...${bundle ? '(Bundling)' : ''} ${chalk.dim(`(${entryPoints.length} files found)`)}`
+			);
+			await esbuild.build({
+				...config,
+				bundle,
+				external: bundle ? Object.keys(dependencies) : undefined,
+				entryPoints,
+				outdir,
+				outExtension: forceCJS ? { '.js': '.cjs' } : {},
+				format,
+				plugins: [dtsGen(buildTsConfig, outdir), ...copyPlugins],
+			});
+			console.log(chalk.dim(`[${date}] `) + chalk.green('√ Build Complete'));
+			break;
+		}
+	}
+}

package/src/cmds/help.js

@@ -0,0 +1,54 @@
+import chalk from 'chalk';
+
+/**
+ * @type {boolean} Indicates if the script is running in a CI environment.
+ */
+const isCI = !!process.env.CI;
+
+/** * Default timeout for tests in milliseconds.
+ * In CI, we set a longer timeout to accommodate potential delays.
+ * In local development, we use a shorter timeout for faster feedback.
+ * @type {number}
+ */
+const defaultTimeout = isCI ? 1400000 : 600000;
+
+/**
+ * Show the help message for the buildkit CLI.
+ */
+export default function showHelp() {
+	console.log(`
+${chalk.green('StudioCMS Buildkit')} - Build tool for StudioCMS packages
+
+${chalk.yellow('Usage:')}
+  buildkit <command> [...files] [...options]
+
+${chalk.yellow('Commands:')}
+  dev                     Watch files and rebuild on changes
+  build                   Perform a one-time build
+  test                    Run tests with Node.js test runner
+  help                    Show this help message
+
+${chalk.yellow('Dev and Build Options:')}
+  --no-clean-dist         Skip cleaning the dist directory
+  --bundle                Enable bundling mode
+  --force-cjs             Force CommonJS output format
+  --tsconfig=<path>       Specify TypeScript config file (default: tsconfig.json)
+  --outdir=<path>         Specify output directory (default: dist)
+
+${chalk.yellow('Test Options:')}
+  -m, --match <pattern>   Filter tests by name pattern
+  -o, --only              Run only tests marked with .only
+  -p, --parallel          Run tests in parallel (default: true)
+  -w, --watch             Watch for file changes and rerun tests
+  -t, --timeout <ms>      Set test timeout in milliseconds (default: ${defaultTimeout})
+  -s, --setup <file>      Specify setup file to run before tests
+  --teardown <file>       Specify teardown file to run after tests
+
+${chalk.yellow('Examples:')}
+  - buildkit dev "src/**/*.ts" --no-clean-dist
+  - buildkit build "src/**/*.ts"
+  - buildkit build "src/**/*.ts" --bundle --force-cjs
+  - buildkit test "test/**/*.test.js" --timeout 50000 
+  - buildkit test "test/**/*.test.js" --match "studiocms" --only
+`);
+}

package/src/cmds/test.js

@@ -0,0 +1,141 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { run } from 'node:test';
+import { spec } from 'node:test/reporters';
+import { pathToFileURL } from 'node:url';
+import { parseArgs } from 'node:util';
+import chalk from 'chalk';
+import { glob } from 'tinyglobby';
+
+/**
+ * @type {boolean} Indicates if the script is running in a CI environment.
+ */
+const isCI = !!process.env.CI;
+
+/** * Default timeout for tests in milliseconds.
+ * In CI, we set a longer timeout to accommodate potential delays.
+ * In local development, we use a shorter timeout for faster feedback.
+ * @type {number}
+ */
+const defaultTimeout = isCI ? 1400000 : 600000;
+
+// DateTime format for logging
+/**
+ * @type {Intl.DateTimeFormat}
+ */
+const dt = new Intl.DateTimeFormat('en-us', {
+	hour: '2-digit',
+	minute: '2-digit',
+});
+
+/**
+ * Run tests using the Node.js test runner.
+ * @param {string[]} args - The command line arguments for the test command.
+ */
+export default async function test(args) {
+	const parsedArgs = parseArgs({
+		args,
+		allowPositionals: true,
+		options: {
+			// aka --test-name-pattern: https://nodejs.org/api/test.html#filtering-tests-by-name
+			match: { type: 'string', alias: 'm' },
+			// aka --test-only: https://nodejs.org/api/test.html#only-tests
+			only: { type: 'boolean', alias: 'o' },
+			// aka --test-concurrency: https://nodejs.org/api/test.html#test-runner-execution-model
+			parallel: { type: 'boolean', alias: 'p' },
+			// experimental: https://nodejs.org/api/test.html#watch-mode
+			watch: { type: 'boolean', alias: 'w' },
+			// Test timeout in milliseconds (default: 30000ms)
+			timeout: { type: 'string', alias: 't' },
+			// Test setup file
+			setup: { type: 'string', alias: 's' },
+			// Test teardown file
+			teardown: { type: 'string' },
+		},
+	});
+
+	// Find the package.json file in the current directory
+	// and read it to get the project name
+	const packageJSONPath = path.resolve('./package.json');
+	let packageJSON;
+	try {
+		packageJSON = JSON.parse(await fs.readFile(packageJSONPath, { encoding: 'utf8' }));
+	} catch (error) {
+		throw new Error(`Failed to read package.json: ${error.message}`);
+	}
+
+	console.log(
+		`${chalk.dim(`[${dt.format(new Date())}]`)} Running tests for ${chalk.bold(packageJSON.name)}...\n`
+	);
+
+	const start = Date.now();
+
+	const pattern = parsedArgs.positionals[0];
+	if (!pattern) throw new Error('Missing test glob pattern');
+
+	const files = await glob(pattern, {
+		onlyFiles: true,
+		absolute: true,
+		ignore: ['**/node_modules/**'],
+	});
+
+	if (files.length === 0) {
+		throw new Error(`No test files found matching pattern: ${pattern}`);
+	}
+
+	// For some reason, the `only` option does not work and we need to explicitly set the CLI flag instead.
+	// Node.js requires opt-in to run .only tests :(
+	// https://nodejs.org/api/test.html#only-tests
+	if (parsedArgs.values.only) {
+		process.env.NODE_OPTIONS ??= '';
+		process.env.NODE_OPTIONS += ' --test-only';
+	}
+
+	if (!parsedArgs.values.parallel) {
+		// If not parallel, we create a temporary file that imports all the test files
+		// so that it all runs in a single process.
+		const tempTestFile = path.resolve('./node_modules/.withstudiocms/test.mjs');
+		await fs.mkdir(path.dirname(tempTestFile), { recursive: true });
+		await fs.writeFile(
+			tempTestFile,
+			files.map((f) => `import ${JSON.stringify(pathToFileURL(f).toString())};`).join('\n')
+		);
+
+		files.length = 0;
+		files.push(tempTestFile);
+	}
+
+	const teardownModule = parsedArgs.values.teardown
+		? await import(pathToFileURL(path.resolve(parsedArgs.values.teardown)).toString())
+		: undefined;
+
+	// https://nodejs.org/api/test.html#runoptions
+	run({
+		files,
+		testNamePatterns: parsedArgs.values.match,
+		concurrency: parsedArgs.values.parallel,
+		only: parsedArgs.values.only,
+		setup: parsedArgs.values.setup,
+		watch: parsedArgs.values.watch,
+		timeout: parsedArgs.values.timeout ? Number(parsedArgs.values.timeout) : defaultTimeout, // Node.js defaults to Infinity, so set better fallback
+	})
+		.on('test:fail', () => {
+			// For some reason, a test fail using the JS API does not set an exit code of 1,
+			// so we set it here manually
+			process.exitCode = 1;
+		})
+		.on('end', () => {
+			const testPassed = process.exitCode === 0 || process.exitCode === undefined;
+			teardownModule?.default(testPassed);
+			const end = Date.now();
+			console.log(
+				`\n${chalk.dim(`[${dt.format(new Date())}]`)} Tests for ${chalk.bold(packageJSON.name)} completed in ${((end - start) / 1000).toFixed(2)} seconds. ${
+					process.exitCode === 0 || process.exitCode === undefined
+						? chalk.green('All tests passed!')
+						: chalk.red('Some tests failed!')
+				}`
+			);
+		})
+		.pipe(new spec())
+		.pipe(process.stdout);
+}

package/src/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import builder from './cmds/builder.js';
+import showHelp from './cmds/help.js';
+import test from './cmds/test.js';
+
+/**
+ * Main function to handle command line arguments and execute the appropriate command.
+ */
+export default async function main() {
+	const [cmd, ...args] = process.argv.slice(2);
+	switch (cmd) {
+		case 'dev':
+		case 'build':
+			await builder(cmd, args);
+			break;
+		case 'test':
+			await test(args);
+			break;
+		default: {
+			showHelp();
+			break;
+		}
+	}
+}
+
+// THIS IS THE ENTRY POINT FOR THE CLI - DO NOT REMOVE
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});

package/index.js

@@ -1,212 +0,0 @@
-#!/usr/bin/env node
-import { execSync } from 'node:child_process';
-import fs from 'node:fs/promises';
-import esbuild from 'esbuild';
-import glob from 'fast-glob';
-import { dim, gray, green, red, yellow } from 'kleur/colors';
-
-/** @type {import('esbuild').BuildOptions} */
-const defaultConfig = {
-	minify: false,
-	format: 'esm',
-	platform: 'node',
-	target: 'node18',
-	sourcemap: false,
-	sourcesContent: false,
-	loader: {
-		'.astro': 'copy',
-		'.d.ts': 'copy',
-		'.json': 'copy',
-		'.gif': 'copy',
-		'.jpeg': 'copy',
-		'.jpg': 'copy',
-		'.png': 'copy',
-		'.tiff': 'copy',
-		'.webp': 'copy',
-		'.avif': 'copy',
-		'.svg': 'copy',
-		'.woff2': 'copy',
-		'.woff': 'copy',
-		'.ttf': 'copy',
-		'.eot': 'copy',
-		'.otf': 'copy',
-	},
-};
-
-const dt = new Intl.DateTimeFormat('en-us', {
-	hour: '2-digit',
-	minute: '2-digit',
-});
-
-const dtsGen = (buildTsConfig, outdir) => ({
-	name: 'TypeScriptDeclarationsPlugin',
-	setup(build) {
-		build.onEnd((result) => {
-			if (result.errors.length > 0) return;
-			const date = dt.format(new Date());
-			console.log(`${dim(`[${date}]`)} Generating TypeScript declarations...`);
-			try {
-				const res = execSync(`tsc --emitDeclarationOnly -p ${buildTsConfig} --outDir ./${outdir}`);
-				console.log(res.toString());
-				console.log(dim(`[${date}] `) + green('√ Generated TypeScript declarations'));
-			} catch (error) {
-				console.error(dim(`[${date}] `) + red(`${error}\n\n${error.stdout.toString()}`));
-			}
-		});
-	},
-});
-
-export default async function run() {
-	const [cmd, ...args] = process.argv.slice(2);
-	const config = Object.assign({}, defaultConfig);
-	const patterns = args
-		.filter((f) => !!f) // remove empty args
-		.map((f) => f.replace(/^'/, '').replace(/'$/, '')); // Needed for Windows: glob strings contain surrounding string chars??? remove these
-	const entryPoints = [].concat(
-		...(await Promise.all(
-			patterns.map((pattern) => glob(pattern, { filesOnly: true, absolute: true }))
-		))
-	);
-	const date = dt.format(new Date());
-
-	const noClean = args.includes('--no-clean-dist');
-	const bundle = args.includes('--bundle');
-	const forceCJS = args.includes('--force-cjs');
-	const buildTsConfig =
-		args.find((arg) => arg.startsWith('--tsconfig='))?.split('=')[1] || 'tsconfig.json';
-	const outdir = args.find((arg) => arg.startsWith('--outdir='))?.split('=')[1] || 'dist';
-
-	const { type = 'module', dependencies = {} } = await readPackageJSON('./package.json');
-
-	const format = type === 'module' && !forceCJS ? 'esm' : 'cjs';
-
-	switch (cmd) {
-		case 'dev': {
-			if (!noClean) {
-				console.log(
-					`${dim(`[${date}]`)} Cleaning ${outdir} directory... ${dim(`(${entryPoints.length} files found)`)}`
-				);
-				await clean(outdir, date, [`!${outdir}/**/*.d.ts`]);
-			}
-
-			const rebuildPlugin = {
-				name: 'dev:rebuild',
-				setup(build) {
-					build.onEnd(async (result) => {
-						const date = dt.format(new Date());
-						if (result?.errors.length) {
-							const errMsg = result.errors.join('\n');
-							console.error(dim(`[${date}] `) + red(errMsg));
-						} else {
-							if (result.warnings.length) {
-								console.info(
-									dim(`[${date}] `) +
-										yellow(`! updated with warnings:\n${result.warnings.join('\n')}`)
-								);
-							}
-							console.info(dim(`[${date}] `) + green('√ updated'));
-						}
-					});
-				},
-			};
-
-			const builder = await esbuild.context({
-				...config,
-				entryPoints,
-				outdir,
-				format,
-				sourcemap: 'linked',
-				plugins: [rebuildPlugin],
-			});
-
-			console.log(
-				`${dim(`[${date}] `) + gray('Watching for changes...')} ${dim(`(${entryPoints.length} files found)`)}`
-			);
-			await builder.watch();
-
-			process.on('beforeExit', () => {
-				builder.stop?.();
-			});
-			break;
-		}
-		case 'build': {
-			if (!noClean) {
-				console.log(
-					`${dim(`[${date}]`)} Cleaning ${outdir} directory... ${dim(`(${entryPoints.length} files found)`)}`
-				);
-				await clean(outdir, date, [`!${outdir}/**/*.d.ts`]);
-			}
-			console.log(
-				`${dim(`[${date}]`)} Building...${bundle ? '(Bundling)' : ''} ${dim(`(${entryPoints.length} files found)`)}`
-			);
-			await esbuild.build({
-				...config,
-				bundle,
-				external: bundle ? Object.keys(dependencies) : undefined,
-				entryPoints,
-				outdir,
-				outExtension: forceCJS ? { '.js': '.cjs' } : {},
-				format,
-				plugins: [dtsGen(buildTsConfig, outdir)],
-			});
-			console.log(dim(`[${date}] `) + green('√ Build Complete'));
-			break;
-		}
-		case 'help': {
-			showHelp();
-			break;
-		}
-		default: {
-			showHelp();
-			break;
-		}
-	}
-}
-
-function showHelp() {
-	console.log(`
-${green('StudioCMS Buildkit')} - Build tool for StudioCMS packages
-
-${yellow('Usage:')}
-  buildkit <command> [...files] [...options]
-
-${yellow('Commands:')}
-  dev     Watch files and rebuild on changes
-  build   Perform a one-time build
-  help    Show this help message
-
-${yellow('Options:')}
-  --no-clean-dist    Skip cleaning the dist directory
-  --bundle          Enable bundling mode
-  --force-cjs       Force CommonJS output format
-  --tsconfig=<path> Specify TypeScript config file (default: tsconfig.json)
-  --outdir=<path>   Specify output directory (default: dist)
-
-${yellow('Examples:')}
-  buildkit build "src/**/*.ts"
-  buildkit dev "src/**/*.ts" --no-clean-dist
-  buildkit build "src/**/*.ts" --bundle --force-cjs
-`);
-}
-
-async function clean(outdir, date, skip = []) {
-	const files = await glob([`${outdir}/**`, ...skip], { filesOnly: true });
-	console.log(dim(`[${date}] `) + dim(`Cleaning ${files.length} files from ${outdir}`));
-	await Promise.all(files.map((file) => fs.rm(file, { force: true })));
-}
-
-async function readPackageJSON(path) {
-	try {
-		const content = await fs.readFile(path, { encoding: 'utf8' });
-		try {
-			return JSON.parse(content);
-		} catch (parseError) {
-			throw new Error(`Invalid JSON in ${path}: ${parseError.message}`);
-		}
-	} catch (readError) {
-		throw new Error(`Failed to read ${path}: ${readError.message}`);
-	}
-}
-
-// THIS IS THE ENTRY POINT FOR THE CLI - DO NOT REMOVE
-run();