@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:

npm install --save-dev @sse-ui/builder

🛠 Usage

Once installed, you can access the utility via the sse-tools command.

Core Commands

| Command | Description | | --------------- | ------------------------------------------------------------------------------------ | | init | To initializes the package with the required configuration files | | 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. | | remove | Safely removes all configuration files and dependencies added by the init command |

⚙️ 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.

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

Example

Go to the Example Click Here

📄 License

This project is licensed under the MIT License.