jiek 2.0.2-alpha.1 → 2.0.2-alpha.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jiek",
   "type": "module",
-  "version": "2.0.2-alpha.1",
+  "version": "2.0.2-alpha.2",
   "description": "A lightweight toolkit for compiling and managing libraries based on `package.json` metadata and suitable for `Monorepo`.",
   "author": "YiJie <yijie4188@gmail.com>",
   "repository": {
@@ -25,26 +25,10 @@
   ],
   "exports": {
     "./package.json": "./package.json",
-    ".": {
-      "source": "./src/index.ts",
-      "require": "./dist/index.cjs",
-      "default": "./dist/index.js"
-    },
-    "./cli": {
-      "source": "./src/cli.ts",
-      "require": "./dist/cli.cjs",
-      "default": "./dist/cli.js"
-    },
-    "./cli-only-build": {
-      "source": "./src/cli-only-build.ts",
-      "require": "./dist/cli-only-build.cjs",
-      "default": "./dist/cli-only-build.js"
-    },
-    "./rollup": {
-      "source": "./src/rollup/index.ts",
-      "require": "./dist/rollup/index.cjs",
-      "default": "./dist/rollup/index.js"
-    }
+    ".": "./src/index.ts",
+    "./cli": "./src/cli.ts",
+    "./cli-only-build": "./src/cli-only-build.ts",
+    "./rollup": "./src/rollup/index.ts"
   },
   "imports": {
     "#~/*": "./src/*"
@@ -62,8 +46,8 @@
     "js-yaml": "^4.1.0",
     "jsonc-parser": "^3.2.1",
     "rollup": "4.13.2",
-    "@jiek/utils": "^0.2.3",
-    "@jiek/pkger": "^0.2.0"
+    "@jiek/pkger": "^0.2.0",
+    "@jiek/utils": "^0.2.3"
   },
   "peerDependencies": {
     "@rollup/plugin-terser": "^0.4.4",
@@ -118,23 +102,7 @@
     "rollup-plugin-esbuild": "^6.1.0",
     "rollup-plugin-swc3": "^0.12.1"
   },
-  "publishConfig": {
-    "directory": "./dist"
-  },
   "scripts": {
     "prepublish": "jb -nm -nc"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "typesVersions": {
-    "<5.0": {
-      "*": [
-        "*",
-        "./dist/*",
-        "./dist/*/index.d.ts",
-        "./dist/*/index.d.mts",
-        "./dist/*/index.d.cts"
-      ]
-    }
   }
 }

package/src/cli-only-build.ts

@@ -0,0 +1,7 @@
+import './utils/filterSupport'
+import './commands/base'
+import './commands/build'
+
+import { program } from 'commander'
+
+program.parse(process.argv)

package/src/cli.ts

@@ -0,0 +1,2 @@
+import './commands/publish'
+import 'jiek/cli-only-build'

package/src/commands/base.ts

@@ -0,0 +1,18 @@
+import { program } from 'commander'
+import pkg from 'jiek/package.json'
+
+import { filterDescription } from '#~/commands/descriptions.ts'
+import { IS_WORKSPACE } from '#~/commands/meta.ts'
+import { type } from '#~/utils/filterSupport.ts'
+
+program
+  .name('jk/jiek')
+  .version(pkg.version)
+  .description(`${pkg.description} - Version ${pkg.version}`)
+  .option('--root <root>', 'The root path of the project')
+  .option('-c, --config-path <configPath>', 'Custom jiek config path')
+
+if (type !== '' && IS_WORKSPACE) {
+  program
+    .option('-f, --filter <filter>', filterDescription)
+}

package/src/commands/build.ts

@@ -0,0 +1,459 @@
+import fs from 'node:fs'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+
+import { confirm } from '@inquirer/prompts'
+import { MultiBar, Presets } from 'cli-progress'
+import { program } from 'commander'
+import { execaCommand } from 'execa'
+
+import { entriesDescription, filterDescription, outdirDescription } from '#~/commands/descriptions.ts'
+import { IS_WORKSPACE } from '#~/commands/meta.ts'
+import type { ProjectsGraph } from '#~/utils/filterSupport.ts'
+import { filterPackagesGraph, getSelectedProjectsGraph } from '#~/utils/filterSupport.ts'
+import { getWD } from '#~/utils/getWD.ts'
+import { loadConfig } from '#~/utils/loadConfig.ts'
+import { tsRegisterName } from '#~/utils/tsRegister.ts'
+
+import type { RollupProgressEvent, TemplateOptions } from '../rollup/base'
+import { BUILDER_TYPE_PACKAGE_NAME_MAP, BUILDER_TYPES } from '../rollup/base'
+
+declare module 'jiek' {
+  export interface Config {
+    build?: TemplateOptions & {
+      /**
+       * Whether to run in silent mode, only active when configured in the workspace root or cwd.
+       *
+       * @default false
+       */
+      silent?: boolean
+    }
+  }
+}
+
+const FILE_TEMPLATE = (manifest: unknown) => (`
+module.exports = require('jiek/rollup').template(${JSON.stringify(manifest, null, 2)})
+`.trimStart())
+
+const require = createRequire(import.meta.url)
+
+const isDefault = process.env.JIEK_IS_ONLY_BUILD === 'true'
+
+const description = `
+Build the package according to the 'exports' field from the package.json.
+If you want to through the options to the \`rollup\` command, you can pass the options after '--'.
+${isDefault ? 'This command is the default command.' : ''}
+`.trim()
+
+interface BuildOptions {
+  /**
+   * Auto-detect the builder from the installed dependencies.
+   * If the builder is not installed, it will prompt the user to install it.
+   * If exists multiple builders, it will fall back to the 'esbuild'.
+   */
+  type?: typeof BUILDER_TYPES[number]
+  /**
+   * The output directory of the build, which relative to the target subpackage root directory.
+   * Support with variables: 'PKG_NAME',
+   * .e.g. 'dist/{{PKG_NAME}}'.
+   *
+   * @default 'dist'
+   */
+  outdir: string
+  watch: boolean
+  silent: boolean
+  verbose: boolean
+  entries?: string
+  external?: string
+  noJs: boolean
+  noDts: boolean
+  noMin: boolean
+  /**
+   * Do not clean the output directory before building.
+   */
+  noClean: boolean
+  onlyMin: boolean
+  /**
+   * The type of minify, support 'terser' and 'builder'.
+   *
+   * @default 'builder'
+   */
+  minType?: string
+  /**
+   * The path of the tsconfig file which is used to generate js and dts files.
+   * If not specified, it will be loaded from:
+   * - ./tsconfig.json
+   * - ./tsconfig.dts.json
+   * - ./tsconfig.build.json
+   */
+  tsconfig?: string
+  /**
+   * The path of the tsconfig file which is used to generate dts files.
+   * If not specified, it will be loaded from:
+   * - ./tsconfig.json
+   * - ./tsconfig.dts.json
+   */
+  dtsconfig?: string
+}
+
+async function checkDependency(dependency: string) {
+  try {
+    require.resolve(dependency)
+  } catch (e) {
+    console.error(`The package '${dependency}' is not installed, please install it first.`)
+    const { notWorkspace } = getWD()
+    const command = `pnpm install -${notWorkspace ? '' : 'w'}D ${dependency}`
+    if (await confirm({ message: 'Do you want to install it now?' })) {
+      await execaCommand(command)
+    } else {
+      console.warn(`You can run the command '${command}' to install it manually.`)
+      process.exit(1)
+    }
+  }
+}
+
+let DEFAULT_BUILDER_TYPE: typeof BUILDER_TYPES[number]
+Object.entries(BUILDER_TYPE_PACKAGE_NAME_MAP).forEach(([type, packageName]) => {
+  try {
+    require.resolve(packageName)
+    DEFAULT_BUILDER_TYPE = type as typeof BUILDER_TYPES[number]
+  } catch { /* empty */ }
+})
+if (!DEFAULT_BUILDER_TYPE!) {
+  DEFAULT_BUILDER_TYPE = 'esbuild'
+}
+
+function parseBoolean(v?: unknown) {
+  if (v === undefined) return true
+  return Boolean(v)
+}
+
+const buildFilterDescription = `
+${filterDescription}
+If you pass the --filter option, it will merge into the filters of the command.
+`.trim()
+
+const buildEntriesDescription = `
+${entriesDescription}
+If you pass the --entries option, it will merge into the entries of the command.
+`.trim()
+
+const command = isDefault
+  ? (() => {
+    const c = program
+      .name('jb/jiek-build')
+      .helpCommand(false)
+    if (IS_WORKSPACE) {
+      c.argument('[filters]', buildFilterDescription)
+    } else {
+      c.argument('[entries]', buildEntriesDescription)
+    }
+    return c
+  })()
+  : program
+    .command(`build [${IS_WORKSPACE ? 'filters' : 'entries'}]`)
+
+command
+  .description(description)
+  .option('-t, --type <TYPE>', `The type of build, support ${BUILDER_TYPES.map(s => `"${s}"`).join(', ')}.`, v => {
+    if (!BUILDER_TYPES.includes(v as any)) {
+      throw new Error(`The value of 'type' must be ${BUILDER_TYPES.map(s => `"${s}"`).join(', ')}`)
+    }
+    return String(v)
+  }, 'esbuild')
+  .option('-o, --outdir <OUTDIR>', outdirDescription, String, 'dist')
+  .option('-e, --entries <ENTRIES>', entriesDescription)
+  .option('--external <EXTERNAL>', 'Specify the external dependencies of the package.', String)
+  .option('-nj, --noJs', 'Do not output js files.', parseBoolean)
+  .option('-nd, --noDts', 'Do not output dts files.', parseBoolean)
+  .option('-nm, --noMin', 'Do not output minify files.', parseBoolean)
+  .option(
+    '--minType <MINTYPE>',
+    'The type of minify, support "builder" and "terser".',
+    v => {
+      if (!['builder', 'terser'].includes(v)) {
+        throw new Error('The value of `minType` must be "builder" or "terser"')
+      }
+      return String(v)
+    }
+  )
+  .option('-nc, --noClean', 'Do not clean the output directory before building.', parseBoolean)
+  .option(
+    '-om, --onlyMin',
+    'Only output minify files, but dts files will still be output, it only replaces the js files.',
+    parseBoolean
+  )
+  .option('--tsconfig <TSCONFIG>', 'The path of the tsconfig file which is used to generate js and dts files.', String)
+  .option('--dtsconfig <DTSCONFIG>', 'The path of the tsconfig file which is used to generate dts files.', String)
+  .option('-w, --watch', 'Watch the file changes.', parseBoolean)
+  .option('-s, --silent', "Don't display logs.", parseBoolean)
+  .option('-v, --verbose', 'Display debug logs.', parseBoolean)
+  .action(async (commandFiltersOrEntries: string | undefined, options: BuildOptions) => {
+    /* eslint-disable prefer-const */
+    let {
+      type,
+      outdir,
+      watch,
+      silent,
+      verbose,
+      entries: optionEntries,
+      external,
+      noJs: withoutJs,
+      noDts: withoutDts,
+      noMin: withoutMin,
+      minType: minifyType,
+      noClean,
+      onlyMin,
+      tsconfig,
+      dtsconfig
+    } = options
+    /* eslint-enable prefer-const */
+    const resolvedType = type ?? DEFAULT_BUILDER_TYPE
+    if (!withoutJs) {
+      await checkDependency(BUILDER_TYPE_PACKAGE_NAME_MAP[resolvedType]!)
+      if (minifyType === 'builder') {
+        minifyType = resolvedType
+      }
+    }
+    if (!withoutMin) {
+      await checkDependency(
+        {
+          ...BUILDER_TYPE_PACKAGE_NAME_MAP,
+          terser: '@rollup/plugin-terser'
+        }[resolvedType]!
+      )
+    }
+    let shouldPassThrough = false
+
+    const passThroughOptions = process.argv
+      .reduce(
+        (acc, value) => {
+          if (shouldPassThrough) {
+            acc.push(value)
+          }
+          if (value === '--') {
+            shouldPassThrough = true
+          }
+          return acc
+        },
+        [] as string[]
+      )
+    const { build } = loadConfig()
+    silent = silent ?? build?.silent ?? false
+
+    if (withoutMin && onlyMin) {
+      throw new Error('Cannot use both --without-minify and --only-minify')
+    }
+    if (onlyMin && withoutJs) {
+      throw new Error('Cannot use --without-js and --only-minify at the same time')
+    }
+
+    let entries: string | undefined = [
+      optionEntries,
+      IS_WORKSPACE ? undefined : commandFiltersOrEntries
+    ].filter(Boolean).join(',')
+    if (entries.length === 0) {
+      entries = undefined
+    }
+    const env = {
+      ...process.env,
+      JIEK_BUILDER: type,
+      JIEK_OUT_DIR: outdir,
+      JIEK_CLEAN: String(!noClean),
+      JIEK_ENTRIES: entries,
+      JIEK_EXTERNAL: external,
+      JIEK_WITHOUT_JS: String(withoutJs),
+      JIEK_WITHOUT_DTS: String(withoutDts),
+      JIEK_WITHOUT_MINIFY: String(withoutMin),
+      JIEK_ONLY_MINIFY: String(onlyMin),
+      JIEK_MINIFY_TYPE: minifyType,
+      JIEK_TSCONFIG: tsconfig,
+      JIEK_DTSCONFIG: dtsconfig
+    }
+
+    const multiBars = new MultiBar({
+      clearOnComplete: false,
+      hideCursor: true,
+      format: '- {bar} | {status} | {pkgName} | {input} | {message}'
+    }, Presets.shades_classic)
+
+    const buildPackage = async ({
+      wd,
+      value = {}
+    }: ProjectsGraph) => {
+      if (Object.keys(value).length === 0) {
+        throw new Error('no package found')
+      }
+      const wdNodeModules = path.resolve(wd, 'node_modules')
+      if (!fs.existsSync(wdNodeModules)) {
+        fs.mkdirSync(wdNodeModules)
+      }
+      const jiekTempDir = (...paths: string[]) => path.resolve(wdNodeModules, '.jiek', ...paths)
+      if (!fs.existsSync(jiekTempDir())) {
+        fs.mkdirSync(jiekTempDir())
+      }
+
+      const rollupBinaryPath = require.resolve('rollup')
+        .replace(/dist\/rollup.js$/, 'dist/bin/rollup')
+      let i = 0
+      await Promise.all(
+        Object.entries(value).map(async ([dir, manifest]) => {
+          if (!manifest.name) {
+            throw new Error('package.json must have a name field')
+          }
+
+          // TODO support auto build child packages in workspaces
+          const escapeManifestName = manifest.name.replace(/^@/g, '').replace(/\//g, '+')
+          const configFile = jiekTempDir(
+            `${escapeManifestName ?? `anonymous-${i++}`}.rollup.config.js`
+          )
+          fs.writeFileSync(configFile, FILE_TEMPLATE(manifest))
+          const command = [rollupBinaryPath, '--silent', '-c', configFile]
+          if (tsRegisterName) {
+            command.unshift(`node -r ${tsRegisterName}`)
+          }
+          if (watch) {
+            command.push('--watch')
+          }
+          command.push(...passThroughOptions)
+          const child = execaCommand(command.join(' '), {
+            ipc: true,
+            cwd: dir,
+            env: {
+              ...env,
+              JIEK_NAME: manifest.name,
+              JIEK_ROOT: wd
+            }
+          })
+          const bars: Record<string, ReturnType<typeof multiBars.create>> = {}
+          const times: Record<string, number> = {}
+          const locks: Record<string, boolean> = {}
+          let inputMaxLen = 10
+          child.on('message', (e: RollupProgressEvent) => {
+            if (e.type === 'debug') console.log(...(Array.isArray(e.data) ? e.data : [e.data]))
+          })
+          !silent && child.on('message', (e: RollupProgressEvent) => {
+            if (e.type === 'init') {
+              const { leafMap, targetsLength } = e.data
+              const leafs = Array
+                .from(leafMap.entries())
+                .flatMap(([input, pathAndCondiions]) =>
+                  pathAndCondiions.map(([path, ...conditions]) => ({
+                    input,
+                    path,
+                    conditions
+                  }))
+                )
+              let initMessage = `Package '${manifest.name}' has ${targetsLength} targets to build`
+              if (watch) {
+                initMessage += ' and watching...'
+              }
+              console.log(initMessage)
+              leafs.forEach(({ input }) => {
+                inputMaxLen = Math.max(inputMaxLen, input.length)
+              })
+              leafs.forEach(({ input, path }) => {
+                const key = `${input}:${path}`
+                if (bars[key]) return
+                bars[key] = multiBars.create(50, 0, {
+                  pkgName: manifest.name,
+                  input: input.padEnd(inputMaxLen + 5),
+                  status: 'waiting'.padEnd(10)
+                }, {
+                  barsize: 20,
+                  linewrap: true
+                })
+              })
+            }
+            if (e.type === 'progress') {
+              const {
+                path,
+                tags,
+                input,
+                event,
+                message
+              } = e.data
+              const bar = bars[`${input}:${path}`]
+              if (!bar) return
+              const time = times[`${input}:${path}`]
+              bar.update(
+                {
+                  start: 0,
+                  resolve: 20,
+                  end: 50
+                }[event ?? 'start'] ?? 0,
+                {
+                  input: (
+                    time
+                      ? `${input}(x${time.toString().padStart(2, '0')})`
+                      : input
+                  ).padEnd(inputMaxLen + 5),
+                  status: event?.padEnd(10),
+                  message: `${tags?.join(', ')}: ${message}`
+                }
+              )
+            }
+            if (e.type === 'watchChange') {
+              const {
+                path,
+                input
+              } = e.data
+              const key = `${input}:${path}`
+              const bar = bars[key]
+              if (!bar) return
+              let time = times[key] ?? 1
+              if (!locks[key]) {
+                time += 1
+                times[key] = time
+                setTimeout(() => {
+                  locks[key] = false
+                }, 100)
+                bar.update(0, {
+                  input: `${input}(x${time.toString().padStart(2, '0')})`.padEnd(inputMaxLen + 5),
+                  status: 'watching'.padEnd(10),
+                  message: 'watching...'
+                })
+              }
+              locks[key] = true
+            }
+          })
+          await new Promise<void>((resolve, reject) => {
+            let errorStr = ''
+            child.stderr?.on('data', (data) => {
+              errorStr += data
+            })
+            child.once('exit', (code) =>
+              code === 0
+                ? resolve()
+                : reject(new Error(`rollup build failed:\n${errorStr}`)))
+            verbose && child.stdout?.pipe(process.stdout)
+          })
+        })
+      )
+    }
+    const commandFilters = IS_WORKSPACE ? commandFiltersOrEntries : undefined
+    const filters = [
+      ...new Set([
+        ...(program.getOptionValue('filter') as string | undefined)
+          ?.split(',')
+          .map(s => s.trim())
+          .filter(s => s.length > 0)
+          ?? [],
+        ...commandFilters
+          ?.split(',')
+          .map(s => s.trim())
+          .filter(s => s.length > 0)
+          ?? []
+      ])
+    ]
+    try {
+      if (filters.length > 0) {
+        const packages = await filterPackagesGraph(filters)
+        await Promise.all(packages.map(buildPackage))
+      } else {
+        await buildPackage(await getSelectedProjectsGraph())
+      }
+    } finally {
+      multiBars.stop()
+    }
+  })

package/src/commands/descriptions.ts

@@ -0,0 +1,17 @@
+export const entriesDescription = `
+Specify the build entry-points of the package.json's 'exports' field.
+Support glob pattern and array.
+.e.g. '.', './*', './sub/*', './a,./b'.
+`.trim()
+
+export const filterDescription = `
+Filter the packages from the workspace.
+Support fuzzy match and array.
+.e.g. 'core,utils'.
+`.trim()
+
+export const outdirDescription = `
+The output directory of the build, which relative to the target subpackage root directory.
+Support with variables: 'PKG_NAME',
+.e.g. 'dist/{{PKG_NAME}}'.
+`.trim()

package/src/commands/meta.ts

@@ -0,0 +1,5 @@
+import { getWD } from '#~/utils/getWD.ts'
+
+const { notWorkspace } = getWD()
+
+export const IS_WORKSPACE = !notWorkspace