@sanity/pkg-utils 7.2.9 → 7.2.10-canary.1

package/src/node/tasks/rolldown/resolveRolldownConfig.ts

@@ -0,0 +1,208 @@
+import path from 'node:path'
+import {optimizeLodashImports} from '@optimize-lodash/rollup-plugin'
+import {getBabelOutputPlugin} from '@rollup/plugin-babel'
+import terser from '@rollup/plugin-terser'
+import type {InputOptions, OutputOptions, Plugin} from 'rolldown'
+import {dts as dtsPlugin} from 'rolldown-plugin-dts'
+import esbuild from 'rollup-plugin-esbuild'
+import type {BuildContext} from '../../core/contexts/buildContext'
+import {pkgExtMap as extMap} from '../../core/pkg/pkgExt'
+import type {PackageJSON} from '../../core/pkg/types'
+import type {RolldownDtsTask} from '../types'
+
+export interface RolldownConfig {
+  inputOptions: InputOptions
+  outputOptions: OutputOptions
+}
+
+export function resolveRolldownConfig(
+  ctx: BuildContext,
+  buildTask: RolldownDtsTask,
+): RolldownConfig {
+  const {format, runtime, target} = buildTask
+  const {config, cwd, exports: _exports, external, distPath, logger, pkg, ts} = ctx
+  const outputExt = extMap[pkg.type || 'commonjs'][format]
+  const minify = config?.minify ?? false
+  const outDir = path.relative(cwd, distPath)
+
+  const pathAliases = Object.fromEntries(
+    Object.entries(ts.config?.options.paths || {}).map(([key, val]) => {
+      return [key, path.resolve(cwd, ts.config?.options.baseUrl || '.', val[0])]
+    }),
+  )
+
+  const entries = buildTask.entries.map((entry) => {
+    return {
+      ...entry,
+      name: path.relative(outDir, entry.output).replace(/\.[^/.]+$/, ''),
+    }
+  }, {})
+
+  const exportIds =
+    _exports && Object.keys(_exports).map((exportPath) => path.join(pkg.name, exportPath))
+
+  const sourcePaths = _exports && Object.values(_exports).map((e) => path.resolve(cwd, e.source))
+
+  const replacements = Object.fromEntries(
+    Object.entries(config?.define || {}).map(([key, val]) => [key, JSON.stringify(val)]),
+  )
+
+  const {optimizeLodash: enableOptimizeLodash = hasDependency(pkg, 'lodash')} = config?.rollup || {}
+
+  // @ts-expect-error - TODO: fix this
+  const _defaultPlugins = [
+    esbuild({
+      target,
+      tsconfig: ctx.ts.configPath || 'tsconfig.json',
+      treeShaking: true,
+      minifySyntax: config?.minify !== false,
+      supported: {
+        'template-literal': true,
+      },
+    }),
+    Array.isArray(config?.babel?.plugins) &&
+      getBabelOutputPlugin({
+        babelrc: false,
+        plugins: config.babel.plugins,
+      }),
+    enableOptimizeLodash &&
+      optimizeLodashImports({
+        useLodashEs: format === 'esm' && hasDependency(pkg, 'lodash-es') ? true : undefined,
+        ...(typeof config?.rollup?.optimizeLodash === 'boolean'
+          ? {}
+          : config?.rollup?.optimizeLodash),
+      }),
+    minify &&
+      terser({
+        compress: {directives: false, passes: 10},
+        ecma: 2020,
+        output: {
+          comments: (_node, comment) => {
+            const text = comment.value
+            const cType = comment.type
+
+            // Check if this is a multiline comment
+            if (cType === 'comment2') {
+              // Keep licensing comments
+              return /@preserve|@license|@cc_on/i.test(text)
+            }
+
+            return false
+          },
+          preserve_annotations: true,
+        },
+      }),
+  ].filter(Boolean) as Plugin[]
+
+  const hashChunkFileNames = config?.rollup?.hashChunkFileNames ?? false
+  const chunksFolder = hashChunkFileNames ? '_chunks' : '_chunks-[format]'
+  const chunkFileNames = `${chunksFolder}/${hashChunkFileNames ? '[name]-[hash]' : '[name]'}${outputExt}`
+  const entryFileNames = `[name]${outputExt}`
+
+  const inputOptions = {
+    cwd,
+    jsx: {
+      mode:
+        config?.jsx === 'automatic'
+          ? 'automatic'
+          : config?.jsx === 'preserve'
+            ? 'preserve'
+            : config?.jsx === 'transform'
+              ? 'classic'
+              : 'automatic',
+      factory: config?.jsxFactory,
+      fragment: config?.jsxFragment,
+      importSource: config?.jsxImportSource,
+    },
+    define:
+      pkg.name === '@sanity/pkg-utils'
+        ? {...replacements}
+        : {
+            'process.env.PKG_FORMAT': JSON.stringify(format),
+            'process.env.PKG_RUNTIME': JSON.stringify(runtime),
+            'process.env.PKG_VERSION': JSON.stringify(process.env['PKG_VERSION'] || pkg.version),
+            ...replacements,
+          },
+
+    platform:
+      buildTask.type === 'rolldown:dts'
+        ? 'node'
+        : runtime === 'node'
+          ? 'node'
+          : runtime === 'browser'
+            ? 'browser'
+            : 'neutral',
+
+    resolve: {
+      alias: pathAliases,
+      tsconfigFilename: ctx.ts.configPath || 'tsconfig.json',
+    },
+    transform: {
+      target,
+    },
+    experimental: {
+      attachDebugInfo: 'none',
+    },
+
+    external: (id, importer) => {
+      // Check if the id is a self-referencing import
+      if (exportIds?.includes(id)) {
+        return true
+      }
+
+      // Check if the id is a file path that points to an exported source file
+      if (importer && (id.startsWith('.') || id.startsWith('/'))) {
+        const idPath = path.resolve(path.dirname(importer), id)
+
+        if (sourcePaths?.includes(idPath)) {
+          logger.warn(
+            `detected self-referencing import – treating as external: ${path.relative(
+              cwd,
+              idPath,
+            )}`,
+          )
+
+          return true
+        }
+      }
+
+      const idParts = id.split('/')
+
+      const name = idParts[0].startsWith('@') ? `${idParts[0]}/${idParts[1]}` : idParts[0]
+
+      if (name && external.includes(name)) {
+        return true
+      }
+
+      return false
+    },
+
+    input: entries.reduce<{[entryAlias: string]: string}>(
+      (acc, entry) => Object.assign(acc, {[entry.name]: entry.source}),
+      {},
+    ),
+
+    plugins: [dtsPlugin({emitDtsOnly: true, tsconfig: ctx.ts.configPath || 'tsconfig.json'})],
+
+    treeshake: true,
+  } satisfies InputOptions
+  const outputOptions = {
+    chunkFileNames,
+    dir: outDir,
+    entryFileNames,
+    esModule: true,
+    format: buildTask.type === 'rolldown:dts' ? 'es' : format,
+    sourcemap: buildTask.type === 'rolldown:dts' ? false : (config?.sourcemap ?? true),
+    hoistTransitiveImports: false,
+  } satisfies OutputOptions
+
+  return {inputOptions, outputOptions}
+}
+
+function hasDependency(pkg: PackageJSON, packageName: string): boolean {
+  return pkg.dependencies
+    ? packageName in pkg.dependencies
+    : pkg.peerDependencies
+      ? packageName in pkg.peerDependencies
+      : false
+}

package/src/node/tasks/rolldown/rolldownDtsTask.ts

@@ -0,0 +1,155 @@
+import path from 'node:path'
+import chalk from 'chalk'
+import {rolldown} from 'rolldown'
+import {from} from 'rxjs'
+import {createConsoleSpy} from '../../consoleSpy'
+import type {BuildContext} from '../../core/contexts/buildContext'
+import type {RolldownDtsTask, TaskHandler} from '../types'
+import {resolveRolldownConfig} from './resolveRolldownConfig'
+
+/** @internal */
+export const rolldownDtsTask: TaskHandler<RolldownDtsTask> = {
+  name: (ctx, task) => {
+    const bundleEntries = task.entries.filter((e) => e.path.includes('__$$bundle_'))
+    const entries = task.entries.filter((e) => !e.path.includes('__$$bundle_'))
+
+    const targetLines = task.target.length
+      ? [`  target:`, ...task.target.map((t) => `    - ${chalk.yellow(t)}`)]
+      : []
+
+    const bundlesLines = bundleEntries.length
+      ? [
+          '  bundles:',
+          ...bundleEntries.map((e) =>
+            [
+              `    - `,
+              `${chalk.yellow(e.source)} ${chalk.gray('→')} ${chalk.yellow(e.output)}`,
+            ].join(''),
+          ),
+        ]
+      : []
+
+    const entriesLines = entries.length
+      ? [
+          '  entries:',
+          ...entries.map((e) =>
+            [
+              `    - `,
+              `${chalk.cyan(path.join(ctx.pkg.name, e.path))}: `,
+              `${chalk.yellow(e.source)} ${chalk.gray('→')} ${chalk.yellow(e.output)}`,
+            ].join(''),
+          ),
+        ]
+      : []
+
+    return [
+      `Build type definitions with ${chalk.bold('rolldown')}...`,
+      `  format: ${chalk.yellow(task.format)}`,
+      ...targetLines,
+      ...bundlesLines,
+      ...entriesLines,
+    ].join('\n')
+  },
+  exec: (ctx, task) => {
+    return from(execPromise(ctx, task))
+    // return new Observable((observer) => {
+    //   execPromise(ctx, task)
+    //     .then((result) => {
+    //       observer.next(result)
+    //       observer.complete()
+    //     })
+    //     .catch((err) => observer.error(err))
+    // })
+  },
+  complete: () => {
+    //
+  },
+  error: (_ctx, _task, err) => {
+    console.error(err)
+  },
+}
+
+async function execPromise(ctx: BuildContext, task: RolldownDtsTask) {
+  const {distPath, files, logger} = ctx
+  const outDir = path.relative(ctx.cwd, distPath)
+
+  // Prevent rolldown from printing directly to the console
+  const consoleSpy = createConsoleSpy({
+    onRestored: (messages) => {
+      for (const msg of messages) {
+        const text = String(msg.args[0])
+
+        if (msg.code === 'CIRCULAR_DEPENDENCY') {
+          continue // ignore
+        }
+
+        if (text.startsWith('Dynamic import can only')) {
+          continue // ignore
+        }
+
+        if (text.startsWith('Sourcemap is likely to be incorrect')) {
+          continue // ignore
+        }
+
+        if (msg.type === 'log') {
+          logger.info(...msg.args)
+        }
+
+        if (msg.type === 'warn') {
+          logger.warn(...msg.args)
+        }
+
+        if (msg.type === 'error') {
+          logger.error(...msg.args)
+        }
+      }
+    },
+  })
+
+  try {
+    const {inputOptions, outputOptions} = resolveRolldownConfig(ctx, task)
+
+    // Create bundle
+    const bundle = await rolldown({
+      ...inputOptions,
+      onwarn(warning) {
+        consoleSpy.messages.push({
+          type: 'warn',
+          code: warning.code,
+          args: [warning.message],
+        })
+      },
+    })
+
+    // generate output specific code in-memory
+    // you can call this function multiple times on the same bundle object
+    const {output} = await bundle.generate(outputOptions)
+
+    for (const chunkOrAsset of output) {
+      if (chunkOrAsset.type === 'asset') {
+        files.push({
+          type: 'asset',
+          path: path.resolve(outDir, chunkOrAsset.fileName),
+        })
+      } else {
+        files.push({
+          type: 'chunk',
+          path: path.resolve(outDir, chunkOrAsset.fileName),
+        })
+      }
+    }
+
+    // or write the bundle to disk
+    await bundle.write(outputOptions)
+
+    // closes the bundle
+    await bundle.close()
+
+    // Restore console
+    consoleSpy.restore()
+  } catch (err) {
+    // Restore console
+    consoleSpy.restore()
+    throw err
+  }
+}

package/src/node/tasks/types.ts

@@ -21,6 +21,16 @@ export interface RollupTask {
   target: string[]
 }
 
+/** @internal */
+export interface RolldownDtsTask {
+  type: 'rolldown:dts'
+  buildId: string
+  entries: RollupTaskEntry[]
+  runtime: PkgRuntime
+  format: 'commonjs' | 'esm'
+  target: string[]
+}
+
 /** @internal */
 export interface RollupWatchTask {
   type: 'watch:js'
@@ -32,7 +42,7 @@ export interface RollupWatchTask {
 }
 
 /** @internal */
-export type BuildTask = DtsTask | RollupTask
+export type BuildTask = DtsTask | RollupTask | RolldownDtsTask
 
 /** @internal */
 export type WatchTask = DtsWatchTask | RollupWatchTask
@@ -49,6 +59,7 @@ export type TaskHandler<Task, Result = void> = {
 export interface BuildTaskHandlers {
   'build:dts': TaskHandler<DtsTask, DtsResult>
   'build:js': TaskHandler<RollupTask>
+  'rolldown:dts': TaskHandler<RolldownDtsTask>
 }
 
 /** @internal */