jiek 2.3.0 → 2.3.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jiek",
   "type": "module",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "A lightweight toolkit for compiling and managing libraries based on `package.json` metadata and suitable for `Monorepo`.",
   "author": "YiJie <yijie4188@gmail.com>",
   "homepage": "https://github.com/NWYLZW/jiek/tree/master/packages/jiek#readme",
@@ -35,6 +35,11 @@
       "jiek/__source__": "./src/rollup/index.ts",
       "require": "./dist/rollup/index.cjs",
       "default": "./dist/rollup/index.js"
+    },
+    "./rollup-plugin-utils": {
+      "jiek/__source__": "./src/rollup-plugin-utils.ts",
+      "require": "./dist/rollup-plugin-utils.cjs",
+      "default": "./dist/rollup-plugin-utils.js"
     }
   },
   "imports": {
@@ -74,13 +79,11 @@
     "js-yaml": "^4.1.0",
     "jsonc-parser": "^3.2.1",
     "koa": "^2.15.3",
+    "magic-string": "^0.30.17",
     "rollup": "^4.0.0",
-    "@jiek/pkger": "^0.2.1",
+    "@jiek/pkger": "^0.2.2",
     "@jiek/utils": "^0.2.3"
   },
-  "publishConfig": {
-    "directory": "./dist/.internal"
-  },
   "peerDependenciesMeta": {
     "@pnpm/filter-workspace-packages": {
       "optional": true

package/rollup-plugin-utils/package.json

@@ -0,0 +1 @@
+{"type":"module","module":"../dist/rollup-plugin-utils.js","main":"../dist/rollup-plugin-utils.cjs"}

package/src/commands/build.ts

@@ -5,6 +5,7 @@ import process from 'node:process'
 import { MultiBar, Presets } from 'cli-progress'
 import { program } from 'commander'
 import { execaCommand } from 'execa'
+import type { Config } from 'jiek'
 
 import type { RollupBuildEvent } from '#~/bridge'
 import type { AnalyzerBuildOptions } from '#~/commands/build/analyzer'
@@ -24,6 +25,10 @@ import { tsRegisterName } from '#~/utils/tsRegister'
 
 declare module 'jiek' {
   interface Config {
+    /**
+     * Skip entries which end with '.js'.
+     */
+    skipJS?: boolean
     build?: TemplateOptions & {
       /**
        * Whether to run in silent mode, only active when configured in the workspace root or cwd.
@@ -51,7 +56,13 @@ If you want to through the options to the \`rollup\` command, you can pass the o
 ${isDefault ? 'This command is the default command.' : ''}
 `.trim()
 
-interface BuildOptions extends AnalyzerBuildOptions {
+interface BuildOptions extends
+  AnalyzerBuildOptions,
+  Pick<
+    Config,
+    'skipJS'
+  >
+{
   /**
    * Auto-detect the builder from the installed dependencies.
    * If the builder is not installed, it will prompt the user to install it.
@@ -179,6 +190,9 @@ command = command
     parseBoolean
   )
 
+command = command
+  .option('--skipJS', 'Skip entries which end with ".js".', parseBoolean)
+
 command = command
   .option('--features.keepImportAttributes', 'Keep the import attributes in the output.')
 
@@ -214,7 +228,8 @@ command
       noClean,
       onlyMin,
       tsconfig,
-      dtsconfig
+      dtsconfig,
+      skipJS
     } = options
     const resolvedType = type ?? DEFAULT_BUILDER_TYPE
     if (!withoutJs) {
@@ -286,6 +301,7 @@ command
       JIEK_MINIFY_TYPE: minifyType,
       JIEK_TSCONFIG: tsconfig,
       JIEK_DTSCONFIG: dtsconfig,
+      JIEK_SKIP_JS: String(skipJS),
       JIEK_FEATURES: JSON.stringify({
         keepImportAttributes: options['features.keepImportAttributes']
       }),

package/src/commands/publish.ts

@@ -5,7 +5,7 @@ import path from 'node:path'
 import process from 'node:process'
 
 import { type BumperType, TAGS, bump } from '@jiek/utils/bumper'
-import { program } from 'commander'
+import { type Command, program } from 'commander'
 import detectIndent from 'detect-indent'
 import type { Config } from 'jiek'
 import type { JSONPath } from 'jsonc-parser'
@@ -60,17 +60,33 @@ async function forEachSelectedProjectsGraphEntries(
   }
 }
 
-program
-  .command('publish')
-  .description(description)
-  .aliases(['pub', 'p'])
-  .option('-b, --bumper <bumper>', 'bump version', 'patch')
-  .option('-no-b, --no-bumper', 'no bump version')
-  .option('-o, --outdir <OUTDIR>', outdirDescription, String, 'dist')
-  .action(async ({ outdir, bumper }: {
-    outdir?: string
-    bumper: false | BumperType
-  }) => {
+interface PublishOptions {
+  outdir?: string
+  bumper: false | BumperType
+  /**
+   * Skip entries which end with '.js'.
+   */
+  skipJS: boolean
+}
+
+const attachPublishOptions = (command: Command) =>
+  command
+    .option('-b, --bumper <bumper>', 'bump version', 'patch')
+    .option('-no-b, --no-bumper', 'no bump version')
+    .option('-o, --outdir <OUTDIR>', outdirDescription, String, 'dist')
+    .option('--skipJS', 'skip entries which end with ".js"')
+
+attachPublishOptions(
+  program
+    .command('publish')
+    .description(description)
+    .aliases(['pub', 'p'])
+)
+  .action(async ({
+    outdir,
+    bumper,
+    skipJS
+  }: PublishOptions) => {
     let shouldPassThrough = false
 
     const passThroughOptions = process.argv
@@ -99,18 +115,21 @@ program
         env: {
           ...process.env,
           JIEK_PUBLISH_OUTDIR: JSON.stringify(outdir),
-          JIEK_PUBLISH_BUMPER: JSON.stringify(bumper)
+          JIEK_PUBLISH_BUMPER: JSON.stringify(bumper),
+          JIEK_PUBLISH_SKIP_JS: JSON.stringify(skipJS)
         }
       })
     })
   })
 
-async function prepublish({ bumper }: {
-  bumper?: boolean | BumperType
-} = {}) {
+async function prepublish({
+  bumper,
+  skipJS
+}: PublishOptions) {
   const {
     JIEK_PUBLISH_OUTDIR: outdirEnv,
-    JIEK_PUBLISH_BUMPER: bumperEnv
+    JIEK_PUBLISH_BUMPER: bumperEnv,
+    JIEK_PUBLISH_SKIP_JS: skipJSEnv
   } = process.env
   const outdir = outdirEnv
     ? JSON.parse(outdirEnv) as string
@@ -118,6 +137,9 @@ async function prepublish({ bumper }: {
   bumper = bumper ?? (
     bumperEnv ? JSON.parse(bumperEnv) as string | boolean : false
   )
+  skipJS = skipJS ?? (
+    skipJSEnv ? JSON.parse(skipJSEnv) as boolean : undefined
+  )
 
   const generateNewManifest = (
     dir: string,
@@ -142,7 +164,8 @@ async function prepublish({ bumper }: {
       config,
       dir,
       noFilter: true,
-      isPublish: true
+      isPublish: true,
+      skipJS: skipJS ?? config.skipJS
     } satisfies Partial<ResolveExportsOptions>
     let resolvedOutdir = outdir
     if (entrypoints) {
@@ -346,7 +369,7 @@ async function prepublish({ bumper }: {
     }
 
     const newVersion = bumper
-      ? bump(oldJSON.version, bumper === true ? 'patch' : bumper)
+      ? bump(oldJSON.version, bumper)
       : oldJSON.version
     const modifyVersionPackageJSON = applyEdits(
       oldJSONString,
@@ -522,7 +545,8 @@ async function prepublish({ bumper }: {
   })
 }
 
-async function postpublish() {
+// eslint-disable-next-line no-empty-pattern
+async function postpublish({}: PublishOptions) {
   await forEachSelectedProjectsGraphEntries(dir => {
     const jiekTempDir = path.resolve(dir, 'node_modules/.jiek/.tmp')
     const packageJSONPath = path.resolve(dir, 'package.json')
@@ -548,24 +572,6 @@ async function postpublish() {
   })
 }
 
-program
-  .action(async () => {
-    const {
-      npm_lifecycle_event: NPM_LIFECYCLE_EVENT
-    } = process.env
-    // eslint-disable-next-line ts/switch-exhaustiveness-check
-    switch (NPM_LIFECYCLE_EVENT) {
-      case 'prepublish':
-        await prepublish()
-        break
-      case 'postpublish':
-        await postpublish()
-        break
-      default:
-        program.help()
-    }
-  })
-
 const prepublishDescription = `
 Prepare package.json for publish, you can add \`jk\` to the \`prepublish\` script in package.json, the command will automatically run \`jk prepublish\`.
 .e.g
@@ -575,11 +581,11 @@ Prepare package.json for publish, you can add \`jk\` to the \`prepublish\` scrip
   }
 }
 `.trim()
-program
-  .command('prepublish')
-  .description(prepublishDescription)
-  .option('-b, --bumper <bumper>', 'bump version')
-  .option('-no-b, --no-bumper', 'no bump version')
+attachPublishOptions(
+  program
+    .command('prepublish')
+    .description(prepublishDescription)
+)
   .action(prepublish)
 
 const postpublishDescription = `
@@ -591,7 +597,32 @@ Restore package.json after publish, you can add \`jk\` to the \`postpublish\` sc
   }
 }
 `.trim()
-program
-  .command('postpublish')
-  .description(postpublishDescription)
+attachPublishOptions(
+  program
+    .command('postpublish')
+    .description(postpublishDescription)
+)
   .action(postpublish)
+
+const {
+  npm_lifecycle_event: NPM_LIFECYCLE_EVENT
+} = process.env
+
+if (
+  NPM_LIFECYCLE_EVENT && [
+    'prepublish',
+    'postpublish'
+  ].includes(NPM_LIFECYCLE_EVENT)
+) {
+  attachPublishOptions(program)
+    .action(async (options: PublishOptions) => {
+      switch (NPM_LIFECYCLE_EVENT) {
+        case 'prepublish':
+          await prepublish(options)
+          break
+        case 'postpublish':
+          await postpublish(options)
+          break
+      }
+    })
+}

package/src/rollup/base.ts

@@ -1,4 +1,5 @@
 import type { InputPluginOption, OutputOptions } from 'rollup'
+import { Replacements } from './plugins/replace'
 
 export type Mapping2ROO<K extends keyof OutputOptions> = OutputOptions[K] | {
   js?: OutputOptions[K]
@@ -134,4 +135,17 @@ export interface TemplateOptions {
    * ```
    */
   injects?: Record<string, string | [string, string]>
+  /**
+   * Replace the specified content in the code.
+   *
+   * @example
+   * ```js
+   * {
+   *   'process.env.DEBUG': 'false',
+   *   'process.env.NODE_ENV': JSON.stringify('production'),
+   *   'process.env.BUILD_PATH': ctx => JSON.stringify(ctx.id)
+   * }
+   * ```
+   */
+  replacements?: Replacements
 }

package/src/rollup/index.ts

@@ -27,6 +27,7 @@ import { getCompilerOptionsByFilePath } from '#~/utils/ts'
 import type { ConfigGenerateContext, TemplateOptions } from './base'
 import createRequire, { CREATE_REQUIRE_VIRTUAL_MODULE_NAME } from './plugins/create-require'
 import progress from './plugins/progress'
+import replace from './plugins/replace'
 import skip from './plugins/skip'
 import withExternal from './plugins/with-external.ts'
 import type { PackageJSON } from './utils/externalResolver'
@@ -46,6 +47,7 @@ const {
   JIEK_ONLY_MINIFY,
   JIEK_TSCONFIG,
   JIEK_DTSCONFIG,
+  JIEK_SKIP_JS,
   JIEK_FEATURES
 } = process.env
 
@@ -82,6 +84,12 @@ const ONLY_MINIFY = JIEK_ONLY_MINIFY === 'true'
 
 const CLEAN = JIEK_CLEAN === 'true'
 
+const SKIP_JS = JIEK_SKIP_JS === 'false'
+  ? false
+  : JIEK_SKIP_JS === 'true'
+  ? true
+  : undefined
+
 const FEATURES = JSON.parse(JIEK_FEATURES ?? '{}') as Record<string, unknown>
 
 const MINIFY_DEFAULT_VALUE = WITHOUT_MINIFY
@@ -105,7 +113,11 @@ const MINIFY_OPTIONS = {
 const config = loadConfig({
   root: WORKSPACE_ROOT
 }) ?? {}
-const { experimental, build = {} } = config
+const {
+  experimental,
+  skipJS,
+  build = {}
+} = config
 const { js: jsOutdir, dts: dtsOutdir } = getOutDirs({
   config,
   pkgName: JIEK_NAME
@@ -412,7 +424,13 @@ const generateConfigs = (
   const { js: jsOutput, dts: dtsOutput } = resolveOutputControls(context, build.output)
   const rollupOptions: RollupOptions[] = []
 
-  const commonPlugins: InputPluginOption[] = [
+  const commonPlugins = (
+    { sourcemap }: { sourcemap?: string | boolean }
+  ): InputPluginOption[] => [
+    replace({
+      sourcemap: sourcemap === 'hidden' ? false : !!sourcemap,
+      values: build.replacements
+    }),
     ...inputCommonPlugins,
     withExternal(),
     !disableCollectInternalModule && {
@@ -559,7 +577,7 @@ const generateConfigs = (
         )
       ],
       plugins: [
-        ...commonPlugins,
+        ...commonPlugins({ sourcemap }),
         nodeResolvePluginInstance,
         import('rollup-plugin-postcss')
           .then(({ default: postcss }) =>
@@ -619,7 +637,7 @@ const generateConfigs = (
         }
       ],
       plugins: [
-        ...commonPlugins,
+        ...commonPlugins({ sourcemap }),
         skip({ patterns: [STYLE_REGEXP] }),
         dts({
           respectExternal: true,
@@ -698,7 +716,8 @@ export function template(packageJSON: PackageJSON): RollupOptions[] {
       entries,
       pkgName: JIEK_NAME!,
       outdir: jsOutdir,
-      config
+      config,
+      skipJS: skipJS ?? SKIP_JS
     })
     getAllLeafs(filteredResolvedEntrypoints as RecursiveRecord<string>, ({ keys, value }) => {
       if (typeof value === 'string') {
@@ -748,7 +767,8 @@ export function template(packageJSON: PackageJSON): RollupOptions[] {
       pkgIsModule,
       pkgName: JIEK_NAME!,
       outdir: `${jsOutdir}/.internal`,
-      config
+      config,
+      skipJS: SKIP_JS ?? skipJS
     })
     getAllLeafs(filteredResolvedInternalEntrypoints as RecursiveRecord<string>, ({ keys, value }) => {
       if (typeof value === 'string') {
@@ -792,7 +812,34 @@ export function template(packageJSON: PackageJSON): RollupOptions[] {
                     : [inputOptions.input as string],
                   internalModules
                 )]
+                if (inputOptions.input.length === 0) {
+                  inputOptions.input = '__jiek_empty__'
+                  const plugins = await inputOptions.plugins
+                  if (!Array.isArray(plugins)) {
+                    throw new TypeError('plugins is not an array')
+                  }
+                  inputOptions.plugins = plugins.filter(
+                    p =>
+                      typeof p !== 'object'
+                        ? true
+                        : p === null
+                        ? true
+                        : 'name' in p && p.name === 'jiek:loadInternalModules'
+                  )
+                }
                 return inputOptions
+              },
+              resolveId: {
+                order: 'post',
+                handler(id) {
+                  if (id === '__jiek_empty__') return id
+                }
+              },
+              load: {
+                order: 'post',
+                handler(id) {
+                  if (id === '__jiek_empty__') return ''
+                }
               }
             }
           ],

package/src/rollup/plugins/replace.ts

@@ -0,0 +1,96 @@
+import type { FilterOptions } from 'jiek/rollup-plugin-utils'
+import { createFilter, definePlugin } from 'jiek/rollup-plugin-utils'
+import MagicString from 'magic-string'
+
+export interface ReplacementFuncCtx {
+  type: 'transform' | 'renderChunk'
+  id: string
+  code: string
+  start: number
+  end: number
+}
+
+export type ReplacementFunc = (ctx: ReplacementFuncCtx) => string
+
+export type Replacements = Record<
+  string,
+  string | ReplacementFunc
+>
+
+export type Options =
+  & FilterOptions
+  & {
+    sourcemap?: boolean
+    values?: Replacements
+  }
+
+export default definePlugin((options: Options = {}) => {
+  const {
+    include = [/\.[cm]?[tj]sx?$/],
+    exclude = [/node_modules/],
+    values = {},
+    sourcemap
+  } = options
+  const allValues = { ...values }
+  const allKeys = Object.keys(allValues)
+  const filter = createFilter({ include, exclude })
+
+  const replaceAll = (ctx: Pick<ReplacementFuncCtx, 'type' | 'id'>, code: string) => {
+    const ms = new MagicString(code)
+    allKeys.forEach(key => {
+      const reg = new RegExp(key, 'g')
+      let match
+      // eslint-disable-next-line no-cond-assign
+      while ((match = reg.exec(code))) {
+        const start = match.index
+        const end = start + key.length
+        ms.overwrite(
+          match.index,
+          match.index + key.length,
+          typeof allValues[key] === 'function'
+            ? allValues[key]({
+              ...ctx,
+              code,
+              start,
+              end
+            })
+            : allValues[key]
+        )
+      }
+    })
+    return ms
+  }
+
+  return {
+    name: 'jiek:replace',
+    transform: {
+      order: 'pre',
+      handler(code, id) {
+        if (allKeys.length === 0) return
+        if (filter(id)) return
+        const ms = replaceAll({ type: 'transform', id }, code)
+        if (ms == null) return
+
+        return {
+          code: ms.toString(),
+          map: sourcemap ? ms.generateMap({ hires: true }) : null
+        }
+      }
+    },
+    renderChunk: {
+      order: 'post',
+      handler(code, { fileName: id }) {
+        if (allKeys.length === 0) return
+        if (filter(id)) return
+
+        const ms = replaceAll({ type: 'renderChunk', id }, code)
+        if (ms == null) return
+
+        return {
+          code: ms.toString(),
+          map: sourcemap ? ms.generateMap({ hires: true }) : null
+        }
+      }
+    }
+  }
+})

package/src/rollup-plugin-utils.ts

@@ -0,0 +1,32 @@
+import { isMatch } from 'micromatch'
+import type { PluginImpl } from 'rollup'
+
+export const definePlugin = <O extends object>(plugin: PluginImpl<O>) => plugin
+
+export interface FilterOptions {
+  include?: string | RegExp | (string | RegExp)[]
+  exclude?: string | RegExp | (string | RegExp)[]
+}
+
+export function createFilter(options: FilterOptions) {
+  const { include = [], exclude = [] } = options
+
+  const resolvedInclude = Array.isArray(include) ? include : [include]
+  const resolvedExclude = Array.isArray(exclude) ? exclude : [exclude]
+
+  return (id: string) => {
+    if (typeof id !== 'string') return false
+    const isInclude = resolvedInclude.length === 0 || resolvedInclude.some(filter => {
+      return filter instanceof RegExp
+        ? filter.test(id)
+        : isMatch(id, filter)
+    })
+    const isExclude = resolvedExclude.length > 0 && resolvedExclude.some(filter => {
+      return filter instanceof RegExp
+        ? filter.test(id)
+        : isMatch(id, filter)
+    })
+
+    return !isInclude || isExclude
+  }
+}

package/src/utils/resolveExports.ts

@@ -4,9 +4,9 @@ import process from 'node:process'
 import {
   type Entrypoints2ExportsOptions,
   type RecursiveRecord,
-  DEFAULT_SKIP_VALUES,
   entrypoints2Exports,
   filterLeafs,
+  getDefaultSkipValues,
   resolveEntrypoints
 } from '@jiek/pkger/entrypoints'
 import type { Config } from 'jiek'
@@ -69,6 +69,7 @@ export interface ResolveExportsOptions {
   defaultOutdir?: string
   noFilter?: boolean
   isPublish?: boolean
+  skipJS?: boolean
 }
 
 export function resolveExports({
@@ -82,7 +83,8 @@ export function resolveExports({
   // FIXME dts support
   outdir = getOutDirs({ pkgName, defaultOutdir, config, cwd: dir }).js,
   noFilter,
-  isPublish
+  isPublish,
+  skipJS
 }: ResolveExportsOptions) {
   const {
     build = {},
@@ -94,7 +96,9 @@ export function resolveExports({
   const {
     crossModuleConvertor = crossModuleConvertorDefault
   } = build
-  const [, resolvedEntrypoints] = resolveEntrypoints(entrypoints)
+  const [, resolvedEntrypoints] = resolveEntrypoints(entrypoints, {
+    allowJS: !skipJS
+  })
   if (entries) {
     Object
       .entries(resolvedEntrypoints)
@@ -110,7 +114,9 @@ export function resolveExports({
       skipValue: [
         // ignore values that filename starts with `.jk-noentry`
         /(^|\/)\.jk-noentry/,
-        ...DEFAULT_SKIP_VALUES
+        ...getDefaultSkipValues({
+          allowJS: !skipJS
+        })
       ]
     }
   )
@@ -151,7 +157,8 @@ export function resolveExports({
       withSource: isPublish ? withSource : undefined,
       withConditional: {
         ...crossModuleWithConditional
-      }
+      },
+      allowJS: !skipJS
     }),
     outdir
   ] as const