susee 2.2.4 → 2.3.0

package/README.md

@@ -10,7 +10,8 @@
 [![NPM][nodei_img]][nodei_url]
 
 [![npm version][npm_v_img]][npm_v_url] [![license][license_img]](LICENSE) [![OpenSSF Baseline](https://www.bestpractices.dev/projects/13115/baseline)](https://www.bestpractices.dev/projects/13115) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13115/badge)](https://www.bestpractices.dev/projects/13115)
-
+> [!IMPORTANT]
+> Use **susee v2.3.0 or above**. The core bundler was ported to Rust in v2.3.0, fixing multiple bugs present in earlier versions. Older versions are no longer recommended.
 ## Overview
 
 `susee` is a **TypeScript-first bundler** powered by `oxc`, specialized for library packages. Unlike general-purpose bundlers, `susee` focuses on consolidating a package's local TypeScript dependency tree into consolidated source units and compiling them into dual-format artifacts (ESM and CommonJS).
@@ -91,6 +92,8 @@ Susee reads your config, bundles each entry point, compiles to ESM and/or Common
 ```
 susee build                           Build using susee.config.{ts,js,mjs}
 susee init                            Generate susee.config.{ts,js,mjs}
+susee check                           Run lint checks on a dependency tree without bundling
+susee bundle <entry> [options]        Bundle a single entry file to disk without compiling
 susee --version / -v                  Print version
 susee --help / -h                     Show help
 susee build <entry> [options]         Build from a single entry file
@@ -102,12 +105,16 @@ susee build <entry> [options]         Build from a single entry file
 |------|------|---------|-------------|
 | `--entry <path>` | string | — | Entry file (optional if given positionally) |
 | `--outdir <path>` | string | `dist` | Output directory |
-| `--format` | `cjs\|commonjs\|esm` | `esm` | Output module format |
+| `--format` | `cjs\|commonjs\|esm\|both` | `esm` | Output module format (`both` = CJS + ESM) |
 | `--tsconfig <path>` | string | `undefined` | Custom tsconfig path |
 | `--allow-update[=true\|false]` | boolean | `false` | Allow `package.json` updates |
 | `--minify[=true\|false]` | boolean | `false` | Minify output JS |
 | `--check[=true\|false]` | boolean | `false` | Run bundler lint checks |
 
+### Bundle Flags
+
+The `susee bundle` command writes the bundled source (before TypeScript compilation) to disk. It supports `--entry`, `--outdir`, and `--check[=true|false]`.
+
 Flags accept both `--flag=value` and `--flag value` syntax.
 
 ### Examples
@@ -115,12 +122,18 @@ Flags accept both `--flag=value` and `--flag value` syntax.
 ```sh
 npx susee build src/index.ts --outdir dist
 npx susee build src/index.ts --format commonjs
+npx susee build src/index.ts --format both        # emit CJS + ESM
 npx susee build --entry src/index.ts --format esm --tsconfig tsconfig.build.json
 npx susee build src/index.ts --minify
+npx susee build src/index.ts --check              # run lint checks during build
+npx susee bundle src/index.ts --outdir bundled   # write bundled source only
+npx susee check                                   # lint the dependency tree from config
 ```
 
 ## Programmatic API
 
+### `build()`
+
 ```ts
 import { build, type SuSeeConfig } from "susee";
 
@@ -137,6 +150,26 @@ await build(config);
 
 `build()` resolves options from the argument first, then from a root config file. If neither is available it logs an error and exits with code 1.
 
+### `suseeBundle()`
+
+Bundle a single entry point into a consolidated source string without compiling or writing to disk:
+
+```ts
+import { suseeBundle, type CheckOptions } from "susee";
+
+const code: string = suseeBundle("src/index.ts");
+
+// with lint checks enabled
+const checks: CheckOptions = {
+  checkAnonymous: true,
+  checkDefaultExports: true,
+  checkNpmInstalled: true,
+};
+const checked = suseeBundle("src/index.ts", checks);
+```
+
+`suseeBundle()` runs the oxc-powered bundler over the entry's local dependency tree and returns the bundled source. When `CheckOptions` are provided the bundler runs diagnostics (anonymous declarations, default exports, npm-installed deps) before returning.
+
 ## How It Works
 
 ```mermaid
@@ -172,13 +205,14 @@ The pipeline bundles each entry point's local dependency tree into a single sour
 
 ```
 src/
-├── index.ts            # Public API — re-exports build + SuSeeConfig
+├── index.ts            # Public API — re-exports build, suseeBundle, SuSeeConfig, CheckOptions
 ├── build.ts            # Build orchestrator — resolves config, runs Compiler
-├── bundler.ts          # Wrapper around @suseejs/susee_bundler (oxc)
+├── bundler.ts          # Wrapper around @suseejs/susee_bundler (oxc) + CLI bundle writer
 ├── cli/
-│   ├── index.ts        # CLI entrypoint & command dispatch
-│   ├── parse_args.ts   # Parses CLI flags into SuSeeConfig
+│   ├── index.ts        # CLI entrypoint & command dispatch (build/init/check/bundle)
+│   ├── parse_args.ts   # Parses CLI flags into SuSeeConfig / bundle opts
 │   ├── init.ts         # `susee init` — scaffolds config file
+│   ├── lint.ts         # `susee check` — runs suseeLint over the dependency tree
 │   └── print_help.ts   # `susee --help` output
 ├── compiler/
 │   ├── index.ts        # Compiler class — bundles + emits CJS/ESM + types
@@ -256,8 +290,8 @@ npm run fmt      # oxfmt
 
 <!-- Need to update version -->
 
-[sb_img]: https://badge.socket.dev/npm/package/susee/1.5.2
-[sb_url]: https://badge.socket.dev/npm/package/susee/1.5.2
+[sb_img]: https://badge.socket.dev/npm/package/susee/2.2.4
+[sb_url]: https://badge.socket.dev/npm/package/susee/2.2.4
 
 <!--  -->
 

package/dist/cli/index.mjs

@@ -2,9 +2,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
 import readline from 'node:readline/promises';
-import tcolor from '@suseejs/color';
 import ts6 from '@suseejs/ts6';
-import { LogTimer, logError, logInfo, suseeBundler } from '@suseejs/susee_bundler';
+import { LogTimer, logError, logInfo, logWarning, suseeBundler, suseeLint } from '@suseejs/susee_bundler';
 import { minify } from 'oxc-minify';
 //src/cli/init.ts
 const tsFileText = `
@@ -181,7 +180,7 @@ function checkEntries(entries) {
     for (const obj of entries) {
         if (!fs.existsSync(path.resolve(process.cwd(), obj.entry))) {
             const info = 'Entry file error';
-            const cause = `Entry file ${obj.entry} dose not exists.`;
+            const cause = `Entry file ${obj.entry} does not exist.`;
             logError(info, cause, true);
         }
     }
@@ -238,6 +237,52 @@ async function finalSuseeConfig() {
         return generateBuildOptions(config);
     }
 }
+async function generateFinalBuildOptions(options) {
+    let buildOptions = {};
+    const _buildOptions = await finalSuseeConfig();
+    if (!options && !_buildOptions) {
+        const info = 'Required build options or susee config file at root.You can use `npx susee init` to create susee config file at root';
+        const cause = 'No build options or susee config file at root.';
+        logError(info, cause, true);
+    }
+    if (options) {
+        buildOptions = generateBuildOptions(options);
+    }
+    else if (_buildOptions) {
+        buildOptions = _buildOptions;
+    }
+    return buildOptions;
+}
+function bundler(point) {
+    const root = process.cwd();
+    const bundled = suseeBundler(point.entry, root, point.checks);
+    if (bundled.moduleType === 2) {
+        logWarning('Your project contains CJS files that were auto-converted. Consider migrating to ESM for better tree-shaking.');
+    }
+    return bundled.bundledCode;
+}
+function suseeBundle(entry, checkOptions) {
+    const root = process.cwd();
+    const opts = checkOptions ? checkOptions : {
+        checkAnonymous: false,
+        checkDefaultExports: false,
+        checkNpmInstalled: false
+    };
+    const bundled = suseeBundler(entry, root, opts);
+    if (bundled.moduleType === 2) {
+        logWarning('Your project contains CJS files that were auto-converted. Consider migrating to ESM for better tree-shaking.');
+    }
+    return bundled.bundledCode;
+}
+async function suseeCliBundle(opts) {
+    const fileName = path.basename(opts.entry);
+    const outDir = opts.outDir ? path.resolve(process.cwd(), opts.outDir) : process.cwd();
+    const outFilePath = path.join(outDir, fileName);
+    const code = suseeBundle(opts.entry, opts.check);
+    if (!fs.existsSync(outDir))
+        await fs.promises.mkdir(outDir, { recursive: true });
+    await fs.promises.writeFile(outFilePath, code);
+}
 function fail(message) {
     const info = message;
     const cause = '';
@@ -266,24 +311,38 @@ function parseBooleanFlag(flag, value) {
         return false;
     fail(`Type of ${flag} must be boolean.`);
 }
+function parseBundleBool(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    fail(`${value} must be "true" or "false".`);
+}
 function parseArgs(argv) {
-    const opts = {};
+    const buildOpts = {};
+    const bundleOpts = {};
     for (let index = 0; index < argv.length; index += 1) {
         const argument = argv[index];
-        if (index === 0 && !argument.startsWith('--') && isFile(argument)) {
-            opts.entry = argument;
+        if (!argument.startsWith('--') && isFile(argument)) {
+            if (buildOpts.entry && isFile(buildOpts.entry))
+                fail('Entry point already exists.');
+            buildOpts.entry = argument;
+            bundleOpts.entry = argument;
             continue;
         }
-        const [flag, inlineValue] = argument.split('=', 2);
+        const eqIndex = argument.indexOf('=');
+        const flag = eqIndex === -1 ? argument : argument.slice(0, eqIndex);
+        const inlineValue = eqIndex === -1 ? undefined : argument.slice(eqIndex + 1);
         const nextValue = argv[index + 1];
         const value = inlineValue ?? nextValue;
         switch (flag) {
             case '--entry':
                 if (!value || value.startsWith('--'))
                     fail('Entry point required.');
-                if (opts.entry && isFile(opts.entry))
+                if (buildOpts.entry && isFile(buildOpts.entry))
                     fail('Entry point already exists.');
-                opts.entry = value;
+                buildOpts.entry = value;
+                bundleOpts.entry = value;
                 if (inlineValue === undefined) {
                     index += 1;
                 }
@@ -291,16 +350,17 @@ function parseArgs(argv) {
             case '--outdir':
                 if (!value || value.startsWith('--'))
                     fail('Output directory required.');
-                opts.outDir = value;
+                buildOpts.outDir = value;
+                bundleOpts.outDir = value;
                 if (inlineValue === undefined) {
                     index += 1;
                 }
                 break;
             case '--format':
-                if (value !== 'cjs' && value !== 'commonjs' && value !== 'esm') {
+                if (value !== 'cjs' && value !== 'commonjs' && value !== 'esm' && value !== 'both') {
                     fail('Format must be cjs, commonjs, esm, both.');
                 }
-                opts.format = value === 'cjs' || value === 'commonjs' ? ['commonjs'] : value === 'esm' ? ['esm'] : value === 'both' ? ['commonjs', 'esm'] : undefined;
+                buildOpts.format = value === 'cjs' || value === 'commonjs' ? ['commonjs'] : value === 'esm' ? ['esm'] : value === 'both' ? ['commonjs', 'esm'] : undefined;
                 if (inlineValue === undefined) {
                     index += 1;
                 }
@@ -308,82 +368,106 @@ function parseArgs(argv) {
             case '--tsconfig':
                 if (!value || value.startsWith('--'))
                     fail('Tsconfig path required.');
-                opts.tsconfig = value;
+                buildOpts.tsconfig = value;
                 if (inlineValue === undefined) {
                     index += 1;
                 }
                 break;
             case '--allow-update':
                 if (inlineValue !== undefined) {
-                    opts.allowUpdate = parseBooleanFlag('allow update', inlineValue);
+                    buildOpts.allowUpdate = parseBooleanFlag('allow update', inlineValue);
                 }
                 else if (nextValue === 'true' || nextValue === 'false') {
-                    opts.allowUpdate = parseBooleanFlag('allow update', nextValue);
+                    buildOpts.allowUpdate = parseBooleanFlag('allow update', nextValue);
                     index += 1;
                 }
                 else {
-                    opts.allowUpdate = true;
+                    buildOpts.allowUpdate = true;
                 }
                 break;
             case '--check':
                 if (inlineValue !== undefined) {
-                    opts.check = parseBooleanFlag('check', inlineValue);
+                    buildOpts.check = parseBooleanFlag('check', inlineValue);
+                    bundleOpts.check = parseBundleBool(inlineValue);
                 }
                 else if (nextValue === 'true' || nextValue === 'false') {
-                    opts.check = parseBooleanFlag('check', nextValue);
+                    buildOpts.check = parseBooleanFlag('check', nextValue);
+                    bundleOpts.check = parseBundleBool(nextValue);
                     index += 1;
                 }
                 else {
-                    opts.check = true;
+                    buildOpts.check = true;
+                    bundleOpts.check = true;
                 }
                 break;
             case '--minify':
                 if (inlineValue !== undefined) {
-                    opts.minify = parseBooleanFlag('minify', inlineValue);
+                    buildOpts.minify = parseBooleanFlag('minify', inlineValue);
                 }
                 else if (nextValue === 'true' || nextValue === 'false') {
-                    opts.minify = parseBooleanFlag('minify', nextValue);
+                    buildOpts.minify = parseBooleanFlag('minify', nextValue);
                     index += 1;
                 }
                 else {
-                    opts.minify = true;
+                    buildOpts.minify = true;
                 }
                 break;
         }
     }
-    return opts;
+    return {
+        buildOpts,
+        bundleOpts
+    };
 }
 function cliConfig(argv) {
-    const cliOpts = parseArgs(argv);
-    if (isEmptyObject(cliOpts))
+    const opts = parseArgs(argv).buildOpts;
+    if (isEmptyObject(opts))
         return undefined;
     const point = {
-        entry: cliOpts.entry ?? '',
+        entry: opts.entry ?? '',
         exportPath: '.',
-        format: cliOpts.format ?? ['esm'],
-        tsconfigFilePath: cliOpts.tsconfig ?? undefined,
-        minify: cliOpts.minify ?? false,
+        format: opts.format ?? ['esm'],
+        tsconfigFilePath: opts.tsconfig ?? undefined,
+        minify: opts.minify ?? false,
         checks: {
-            checkAnonymous: cliOpts.check ? true : false,
-            checkDefaultExports: cliOpts.check ? true : false,
-            checkNpmInstalled: cliOpts.check ? true : false
+            checkAnonymous: opts.check ? true : false,
+            checkDefaultExports: opts.check ? true : false,
+            checkNpmInstalled: opts.check ? true : false
         }
     };
     if (point.entry === '')
         return undefined;
     const config = {
         entryPoints: [point],
-        outDir: cliOpts.outDir ?? 'dist',
-        allowUpdatePackageJson: cliOpts.allowUpdate ?? false
+        outDir: opts.outDir ?? 'dist',
+        allowUpdatePackageJson: opts.allowUpdate ?? false
     };
     return config;
 }
+function cliBundleOpts(argv) {
+    const opts = parseArgs(argv).bundleOpts;
+    if (isEmptyObject(opts))
+        return undefined;
+    if (!opts.entry)
+        return undefined;
+    const options = {
+        entry: opts.entry,
+        outDir: opts.outDir,
+        check: opts.check ? {
+            checkAnonymous: true,
+            checkDefaultExports: true,
+            checkNpmInstalled: true
+        } : undefined
+    };
+    return options;
+}
 //src/cli/print_help.ts
 function printHelp() {
     console.log(`Susee CLI.
 Usage:
   susee build                           Build using susee.config.{ts,js,mjs}
   susee init                            Generate susee.config.{ts,js,mjs}
+  susee check                           Run lint checks on a dependency tree without bundling.
   susee --help                          Show this message
   susee build <entry> [options]         Build from a single entry file
 Options:
@@ -393,7 +477,7 @@ Options:
   --tsconfig <path>                    Custom tsconfig path. (default to undefined)
   --allow-update[=true|false]          Enable package.json update. (default to false)
   --minify[=true|false]                Enable minify to output JS code.(default to false)
-  --check[=true|false]                Enable minify to output JS code.(default to false)
+  --check[=true|false]                Enable lint checks on bundled output.(default to false)
 Notes:
   Duplicate top-level declarations fail the build with file and location output.
   Rename conflicting declarations in source files before bundling.
@@ -432,8 +516,9 @@ var files;
     files_1.deleteFile = deleteFile;
     async function readFile(filePath) {
         if (!existsPath(filePath)) {
-            console.error(tcolor.magenta(`> ${filePath} does not exists `));
-            process.exit(1);
+            const info = `${filePath} does not exists`;
+            const cause = `When reading ${filePath}, file does not exists`;
+            logError(info, cause, true);
         }
         filePath = resolvePath(filePath);
         const readContent = await fs.promises.readFile(filePath);
@@ -510,7 +595,9 @@ var files;
         const pkgFile = resolvePath('package.json');
         const pkgtext = await readJsonFile(pkgFile);
         let { name, version, description, main, module, type, types, exports, ...rest } = pkgtext;
-        type = 'module';
+        const hasCjs = files.commonjs !== undefined;
+        const hasEsm = files.esm !== undefined;
+        type = hasCjs && !hasEsm ? 'commonjs' : 'module';
         let _main = {};
         let _module = {};
         let _types = {};
@@ -519,7 +606,11 @@ var files;
             _main = files.main ? { main: path.relative(process.cwd(), files.main) } : {};
             _module = files.module ? { module: path.relative(process.cwd(), files.module) } : {};
             _types = files.types ? { types: path.relative(process.cwd(), files.types) } : {};
-            _exports = { exports: { ...getExports(files, exportPath) } };
+            const normalizedExports = exports && typeof exports === 'object' && !Array.isArray(exports) ? { ...exports } : {};
+            _exports = { exports: {
+                    ...normalizedExports,
+                    ...getExports(files, exportPath)
+                } };
         }
         else {
             _main = main ? { main } : {};
@@ -572,7 +663,7 @@ function jsxCompilerOptions(sourceCode, compilerOptions, isJsx) {
         const pattern = `import\\s+(?:.*?)\\s+from\\s+("${txt}"|"${txt}\\/.*")`;
         const re = new RegExp(pattern, 'gm');
         if (!re.test(sourceCode)) {
-            console.error('[jsx-runtime-mismatch-error]:\nJSX syntax found in bundled code,but its not react runtime and jsx-runtime from bundled code and jsxImportSource from tsconfig are mismatched.`');
+            console.error('[jsx-runtime-mismatch-error]:\nJSX syntax found in bundled code,but its not react runtime and jsx-runtime from bundled code and jsxImportSource from tsconfig are mismatched.');
             process.exit(1);
         }
     }
@@ -739,18 +830,6 @@ function getCompilerOptions(customConfigPath) {
         defaultOptions
     };
 }
-//src/bundler.ts
-function bundler(point) {
-    // const bundledCodeCache: WeakMap<BuildEntryPoint, string> = new WeakMap();
-    const root = process.cwd();
-    // let bundledCode = bundledCodeCache.get(point);
-    // if (!bundledCode) {
-    //   bundledCode = suseeBundler(point.entry,root,point.checks).bundledCode;
-    //   bundledCodeCache.set(point, bundledCode);
-    // }
-    // return bundledCode;
-    return suseeBundler(point.entry, root, point.checks).bundledCode;
-}
 //src/helpers/minify.ts
 async function oxcMinify(fileName, code, point) {
     const options = typeof point.minify === 'object' && typeof point.minify !== 'boolean' ? point.minify.options : undefined;
@@ -758,7 +837,6 @@ async function oxcMinify(fileName, code, point) {
     return result.code;
 }
 //src/compiler/index.ts
-//import { utils } from "../helpers/utilities.js";
 /**
 * Checks if the given code string contains JSX syntax.
 * @param code The content of the file as a string.
@@ -872,6 +950,8 @@ class Compiler {
             }
             if (isMain && this._files.esm) {
                 this._files.module = this._files.esm;
+                if (this._files.esmTypes)
+                    this._files.types = this._files.esmTypes;
             }
         }
         await files.writeFile(mainFilePath, compiledCode);
@@ -888,6 +968,15 @@ class Compiler {
     async compile() {
         await files.clearFolder(this._object.outDir);
         for (const point of this._object.buildEntryPoints) {
+            this._files = {
+                commonjs: undefined,
+                commonjsTypes: undefined,
+                esm: undefined,
+                esmTypes: undefined,
+                main: undefined,
+                module: undefined,
+                types: undefined
+            };
             const bundleCode = bundler(point);
             for (const format of point.format) {
                 switch (format) {
@@ -920,23 +1009,36 @@ class Compiler {
 */
 async function build(options) {
     const buildTime = new LogTimer();
-    let buildOptions = {};
-    const _buildOptions = await finalSuseeConfig();
-    if (!options && !_buildOptions) {
-        const info = 'Required build options or susee config file at root.You can use `npx susee init` to create susee config file at root';
-        const cause = 'No build options or susee config file at root.';
-        logError(info, cause, true);
-    }
-    if (options) {
-        buildOptions = generateBuildOptions(options);
-    }
-    else if (_buildOptions) {
-        buildOptions = _buildOptions;
-    }
+    const buildOptions = await generateFinalBuildOptions(options);
     const compiler = new Compiler(buildOptions);
     await compiler.compile();
     buildTime.buildTime();
 }
+//src/cli/lint.ts
+async function suseeCheck() {
+    const buildOptions = await generateFinalBuildOptions();
+    const lintOptions = {
+        checkAnonymous: true,
+        checkDefaultExports: true,
+        checkNpmInstalled: true
+    };
+    for (const point of buildOptions.buildEntryPoints) {
+        const result = suseeLint(point.entry, '.', lintOptions);
+        for (const diag of result.errors) {
+            const location = `${diag.file}:${diag.line}:${diag.column}`;
+            const details = diag.details.length ? `\n${diag.details.map((d) => `  ${d}`).join('\n')}` : '';
+            logError(`[${diag.rule}] ${location} — ${diag.message}${details}`, diag.rule);
+        }
+        for (const diag of result.warnings) {
+            const location = `${diag.file}:${diag.line}:${diag.column}`;
+            const details = diag.details.length ? `\n${diag.details.map((d) => `  ${d}`).join('\n')}` : '';
+            logWarning(`[${diag.rule}] ${location} — ${diag.message}${details}`);
+        }
+        if (result.errors.length === 0 && result.warnings.length === 0) {
+            logInfo(`All checks passed for ${point.entry}`);
+        }
+    }
+}
 //src/cli/index.ts
 async function getPackageVersion() {
     const pkgPath = path.resolve(process.cwd(), 'package.json');
@@ -965,6 +1067,9 @@ async function cliBuild() {
             case 'init':
                 await cliInit();
                 break;
+            case 'check':
+                await suseeCheck();
+                break;
             case '--version':
             case '-v':
                 logInfo(`susee v${version}`);
@@ -983,6 +1088,16 @@ async function cliBuild() {
         const config = cliConfig(restArgs);
         await build(config);
     }
+    else if (args.length > 1 && args[0] === 'bundle') {
+        const restArgs = args.slice(1);
+        const opts = cliBundleOpts(restArgs);
+        if (opts) {
+            await suseeCliBundle(opts);
+        }
+        else {
+            errorLog();
+        }
+    }
     else {
         errorLog();
     }