@sse-ui/builder 1.2.0 → 1.3.1

package/README.md

@@ -0,0 +1,76 @@
+# @sse-ui/builder (sse-tools)
+
+`sse-tools` is a high-performance CLI utility designed for managing, building, and publishing software packages within the SSE ecosystem. It provides a unified interface for library development, supporting both Babel for individual file transpilation and esbuild for high-speed bundling.
+
+## ✨ Features
+
+- **Hybrid Builder Engine**: Seamlessly switch between Babel for detailed transpilation or esbuild for rapid bundling via simple configuration.
+- **Vite-style Watch Mode**: Features an incremental watcher that rebuilds only the specific files you change, significantly speeding up development loops.
+- **Intelligent Export Management**: Automatically generates and optimizes your package.json exports field based on your build output, supporting both flat and nested structures.
+- **TypeScript-First**: Built-in support for generating and bundling .d.ts declaration files using either standard tsc or the high-performance tsgo compiler.
+- **React Compiler Support**: Integrated support for the React compiler, including automatic environment configuration and peer-dependency validation.
+- **Interactive Versioning**: A CLI-guided versioning system that helps you bump package versions safely using SemVer standards.
+
+## 🚀 Installation
+
+Install the package as a development dependency:
+
+```bash
+npm install --save-dev @sse-ui/builder
+```
+
+## 🛠 Usage
+
+Once installed, you can access the utility via the `sse-tools` command.
+
+### Core Commands
+
+| Command         | Description                                                                          |
+| --------------- | ------------------------------------------------------------------------------------ |
+| `build`         | Compiles the package for production using Babel or esbuild.                          |
+| `watch`         | Starts an incremental rebuild watcher for rapid development.                         |
+| `typecheck`     | Validates TypeScript types across the project without emitting files.                |
+| `check-exports` | Verifies that all files declared in package.json actually exist in the build folder. |
+| `version`       | Interactively bumps the package version (patch, minor, major).                       |
+| `publish`       | Publishes the built package directly from your specified build directory.            |
+| `info`          | Displays size and file statistics for your built package.                            |
+| `clean`         | Safely removes the build directory to ensure a fresh start.                          |
+
+## ⚙️ Configuration
+
+`sse-tools` uses `c12` for robust configuration loading. You can define your configuration in `sse.config.ts`, `sse.config.js`, or within your `package.json`.
+
+```typescript
+import { defineConfig } from "@sse-ui/builder/config";
+
+export default defineConfig({
+  bundle: ["esm", "cjs"],
+  buildTypes: true,
+  flat: false,
+
+  // Use esbuild for bundling single files
+  esbuild: {
+    entry: "src/index.ts",
+    target: "es2022",
+  },
+});
+```
+
+### Build Options
+
+- `bundle`: Specify output formats, such as `["esm", "cjs"]`.
+- `flat`: When enabled, builds a flat structure instead of using format-specific subdirectories.
+- `copy`: Define an array of glob patterns to copy static assets or documentation into the build folder.
+- `tsgo`: Toggle between `tsc` and `tsgo` for faster type generation.
+
+## Docs
+
+Go to the Docs [click here](./docs)
+
+## Example
+
+Go to the Example [Click Here](./example)
+
+## 📄 License
+
+This project is licensed under the `MIT` License.

package/dist/{babel-RJOLF3H5.js → babel-2PBTAJV6.js}

@@ -2,9 +2,8 @@ import {
   build,
   cjsCopy,
   getVersionEnvVariables
-} from "./chunk-MBPIJFGX.js";
-import "./chunk-B6FMAT44.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-6NNEV5YX.js";
+import "./chunk-N46AJ2OI.js";
 export {
   build,
   cjsCopy,

package/dist/babel-config.js

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/babel-config.ts
 import pluginTransformRuntime from "@ssets/babel/plugin/transform-runtime";
 import presetEnv from "@ssets/babel/preset/env";
@@ -127,7 +125,9 @@ function getBaseConfig({
       ],
       [presetTypescript]
     ],
-    plugins
+    plugins,
+    minified: process.env.SSE_MINIFY === "true",
+    shouldPrintComment: (val) => process.env.SSE_MINIFY !== "true" || /[@#]__PURE__|license|copyright/i.test(val)
   };
 }
 function getBabelConfig(api) {

package/dist/{chunk-MBPIJFGX.js → chunk-6NNEV5YX.js}

@@ -1,6 +1,6 @@
 import {
   BASE_IGNORES
-} from "./chunk-B6FMAT44.js";
+} from "./chunk-N46AJ2OI.js";
 
 // src/utils/babel.ts
 import { findWorkspacesRoot } from "find-workspaces";
@@ -8,6 +8,7 @@ import { $ } from "execa";
 import { globby } from "globby";
 import * as fs from "fs/promises";
 import * as path from "path";
+import chalk from "chalk";
 var TO_TRANSFORM_EXTENSIONS = [".js", ".ts", ".tsx"];
 function getVersionEnvVariables(pkgVersion) {
   if (!pkgVersion) {
@@ -29,7 +30,7 @@ function getVersionEnvVariables(pkgVersion) {
 async function cjsCopy({ from, to }) {
   const exists = await fs.stat(to).then(() => true).catch(() => false);
   if (!exists) {
-    console.warn(`path ${to} does not exists`);
+    console.warn(chalk.yellow(`\u26A0\uFE0F path ${to} does not exist`));
     return;
   }
   const files = await globby("**/*.cjs", { cwd: from });
@@ -51,11 +52,14 @@ async function build({
   removePropTypes = false,
   verbose = false,
   ignores = [],
-  reactCompiler
+  reactCompiler,
+  minify = false
 }) {
   if (verbose) {
     console.log(
-      `Transpiling files to "${path.relative(path.dirname(sourceDir), outDir)}" for "${bundle}" bundle.`
+      chalk.blue(
+        `Transpiling files to "${path.relative(path.dirname(sourceDir), outDir)}" for "${bundle}" bundle.`
+      )
     );
   }
   const workspaceDir = await findWorkspacesRoot(cwd);
@@ -76,9 +80,11 @@ async function build({
     SSE_OUT_FILE_EXTENSION: outExtension ?? ".js",
     ...getVersionEnvVariables(pkgVersion),
     SSE_REACT_COMPILER: reactVersion ? "1" : "0",
-    SSE_REACT_COMPILER_REACT_VERSION: reactVersion
+    SSE_REACT_COMPILER_REACT_VERSION: reactVersion,
+    SSE_MINIFY: minify ? "true" : void 0
   };
   const resolvedOutExtension = outExtension ?? ".js";
+  const minifiedArgs = minify ? ["--minified"] : [];
   const res = await $({
     stdio: "inherit",
     preferLocal: true,
@@ -87,7 +93,7 @@ async function build({
       ...process.env,
       ...env
     }
-  })`babel --config-file ${configFile} --extensions ${TO_TRANSFORM_EXTENSIONS.join(
+  })`babel --config-file ${configFile} ${minifiedArgs} --extensions ${TO_TRANSFORM_EXTENSIONS.join(
     ","
   )} ${sourceDir} --out-dir ${outDir} --ignore ${BASE_IGNORES.concat(
     ignores
@@ -99,10 +105,9 @@ ${res.stderr}`
     );
   }
   if (verbose) {
-    console.log(
-      `Command: '${res.escapedCommand}' succeeded with 
-${res.stdout}`
-    );
+    const output = res.stdout ? `
+${res.stdout}` : "";
+    console.log(chalk.green(`\u2705 Babel compilation succeeded!${output}`));
   }
 }
 

package/dist/{chunk-B6FMAT44.js → chunk-N46AJ2OI.js}

@@ -4,6 +4,7 @@ import * as path from "path";
 import { globby } from "globby";
 import { minimatch } from "minimatch";
 import * as semver from "semver";
+import chalk from "chalk";
 function getOutExtension(bundle, options = {}) {
   const { isType = false, isFlat = false, packageType = "commonjs" } = options;
   const normalizedPackageType = packageType === "module" ? "module" : "commonjs";
@@ -548,7 +549,8 @@ async function addLicense({
 ${content}`,
     { encoding: "utf8" }
   );
-  if (process.env.SSE_BUILD_VERBOSE) console.log(`License added to ${file}`);
+  if (process.env.SSE_BUILD_VERBOSE)
+    console.log(chalk.gray(`License added to ${file}`));
 }
 async function writePackageJson({
   packageJson,