feat: update bundle formats

[ivodolenc]

Type of Change

• New feature
• Documentation
• Breaking change

Breaking Changes

Changes default file formats for generated .js and .d.ts files .

Formats

During transformation, file formats are automatically resolved and in most cases there is no need for additional configuration.

Hyperbundler module environment for generated files defaults to esm, which means the outputs will have a .mjs extension unless otherwise specified. For TypeScript declarations, the appropriate extension will be .d.mts.

Formats can also be explicitly specified for each entry, if necessary.

Inputs

Default transformation behaviour for all chunk entries:

• ./srcDir/file.js resolves to ./outDir/file.mjs
• ./srcDir/file.mjs resolves to ./outDir/file.mjs
• ./srcDir/file.cjs resolves to ./outDir/file.cjs
• ./srcDir/file.ts resolves to ./outDir/file.mjs
• ./srcDir/file.mts resolves to ./outDir/file.mjs
• ./srcDir/file.cts resolves to ./outDir/file.cjs

Declarations

Default transformation behaviour for all dts entries:

• ./srcDir/file.ts resolves to ./outDir/file.d.mts

Features

Adds dts alias for declaration entries.

Entry Declaration

Builds TypeScript declaration files (.d.ts) for production.

// bundler.config.ts

import { defineConfig } from '@hypernym/bundler'

export default defineConfig({
  entries: [
    { declaration: './src/types.ts' }, // => './dist/types.d.mts'
  ],
})

Also, it is possible to use dts alias.

import { defineConfig } from '@hypernym/bundler'

export default defineConfig({
  entries: [
    { dts: './src/types.ts' }, // => './dist/types.d.mts'
  ],
})

Other Changes

• Improves types
• Improves docs