feat: bundling #10

unicornware · 2022-09-25T02:05:48Z

Description

📦 Build

cli: distribute cli as bundle
deps-peer: require at least typescript@3.7

✨ Features

interfaces: Config#bundle?
interfaces: Config#ext?
interfaces: Config#format?
interfaces: Config#source?
interfaces: Entry#bundle?
interfaces: Entry#name?
options: only write dts files
types: EsbuildOptions
types: OutputExtension
utils: getCompilerOptions
utils: loaders

🏡 Housekeeping

pkg: add check:types:build script

🔥 Performance Improvements

build all source files at once
- majorly improves declaration file generation speed

⚡ Refactors

pass esbuild options via build entries
config: default loadBuildConfig search location to '.'
interfaces: make Entry#declaration optional
node: support bundling
plugins: [dts] normalize user compiler options
plugins: [dts] respect user compiler options
utils: [esbuilder] set entryNames
utils: esbuild loader configuration
- pick loader based on entry.bundle and/or entry.format
utils: support esbuild bundling and code splitting options

✅ Testing

plugins: check for esbuild errors and warnings
utils: [write] separate black box and white box techniques
utils: remove plugin mocks from esbuilder integration tests

Tests

`yarn test:cov`

RUN  v0.23.1
      Coverage enabled with c8

✓ src/__tests__/make.functional.spec.ts > functional:make > should load build config
 ✓ src/__tests__/make.functional.spec.ts > functional:make > should clean output directories
 ✓ src/__tests__/make.functional.spec.ts > functional:make > should write all build results
 ✓ src/__tests__/make.functional.spec.ts > functional:make > should write dts build results only
 ✓ src/__tests__/make.spec.ts > unit:make > build > should determine current working directory
 ✓ src/__tests__/make.spec.ts > unit:make > build > should load package.json from current working directory
 ✓ src/__tests__/make.spec.ts > unit:make > build > should print build start info
 ✓ src/__tests__/make.spec.ts > unit:make > build > should build source files
 ✓ src/__tests__/make.spec.ts > unit:make > build > should write build results
 ✓ src/__tests__/make.spec.ts > unit:make > build > should print build done info
 ✓ src/__tests__/make.spec.ts > unit:make > build > should print build analysis
 ✓ src/__tests__/make.spec.ts > unit:make > build > should print total build size
 ✓ src/__tests__/make.spec.ts > unit:make > build > should return build results
 ✓ src/__tests__/make.spec.ts > unit:make > error handling > should exit early if package.json is not found
 ✓ src/__tests__/make.spec.ts > unit:make > error handling > should exit early if error building source file
 ✓ src/__tests__/make.spec.ts > unit:make > error handling > should exit early if error writing build result
 ✓ src/config/__tests__/define.spec.ts > unit:config/defineBuildConfig > should return build config object
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.cjs
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.cts
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.js
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.json
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.mjs
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.mts
 ✓ src/config/__tests__/load.integration.spec.ts > integration:config/loadBuildConfig > cosmiconfig > should load config from build.config.ts
 ✓ src/config/__tests__/load.spec.ts > unit:config/loadBuildConfig > should return empty object if config is not found
 ✓ src/config/__tests__/loader-es.spec.ts > unit:config/esLoader > should return config from .cts file
 ✓ src/config/__tests__/loader-es.spec.ts > unit:config/esLoader > should return config from .js file
 ✓ src/config/__tests__/loader-es.spec.ts > unit:config/esLoader > should return config from .mjs file
 ✓ src/config/__tests__/loader-es.spec.ts > unit:config/esLoader > should return config from .mts file
 ✓ src/config/__tests__/loader-es.spec.ts > unit:config/esLoader > should return config from .ts file
 ✓ src/plugins/dts/__tests__/plugin.integration.spec.ts > integration:plugins/dts > esbuild > should add .d.cts output
 ✓ src/plugins/dts/__tests__/plugin.integration.spec.ts > integration:plugins/dts > esbuild > should add .d.cts output for copied file
 ✓ src/plugins/dts/__tests__/plugin.integration.spec.ts > integration:plugins/dts > esbuild > should add .d.mts output
 ✓ src/plugins/dts/__tests__/plugin.integration.spec.ts > integration:plugins/dts > esbuild > should add .d.mts output for copied file
 ✓ src/plugins/dts/__tests__/plugin.integration.spec.ts > integration:plugins/dts > esbuild > should add .d.ts output
 ✓ src/plugins/dts/__tests__/plugin.integration.spec.ts > integration:plugins/dts > esbuild > should skip files that are not javascript or typescript
 ✓ src/plugins/dts/__tests__/plugin.spec.ts > unit:plugins/dts > should do nothing if bundling
 ✓ src/plugins/dts/__tests__/plugin.spec.ts > unit:plugins/dts > should throw if metafile is not available
 ✓ src/plugins/fully-specified/__tests__/plugin.integration.spec.ts > integration:plugins/fully-specified > esbuild > should fill specifiers in cjs output files
 ✓ src/plugins/fully-specified/__tests__/plugin.integration.spec.ts > integration:plugins/fully-specified > esbuild > should fill specifiers in copied output files
 ✓ src/plugins/fully-specified/__tests__/plugin.integration.spec.ts > integration:plugins/fully-specified > esbuild > should fill specifiers in esm output files
 ✓ src/plugins/fully-specified/__tests__/plugin.integration.spec.ts > integration:plugins/fully-specified > esbuild > should skip files that are not javascript or typescript
 ✓ src/plugins/fully-specified/__tests__/plugin.spec.ts > unit:plugins/fully-specified > should do nothing if bundling
 ✓ src/plugins/fully-specified/__tests__/plugin.spec.ts > unit:plugins/fully-specified > should throw if metafile is not available
 ✓ src/plugins/tsconfig-paths/__tests__/plugin.integration.spec.ts > integration:plugins/tsconfig-paths > esbuild > should resolve path aliases in cjs output files
 ✓ src/plugins/tsconfig-paths/__tests__/plugin.integration.spec.ts > integration:plugins/tsconfig-paths > esbuild > should resolve path aliases in copied output files
 ✓ src/plugins/tsconfig-paths/__tests__/plugin.integration.spec.ts > integration:plugins/tsconfig-paths > esbuild > should resolve path aliases esm output files
 ✓ src/plugins/tsconfig-paths/__tests__/plugin.integration.spec.ts > integration:plugins/tsconfig-paths > esbuild > should skip files that are not javascript or typescript
 ✓ src/plugins/tsconfig-paths/__tests__/plugin.spec.ts > unit:plugins/tsconfig-paths > should do nothing if bundling
 ✓ src/plugins/tsconfig-paths/__tests__/plugin.spec.ts > unit:plugins/tsconfig-paths > should throw if metafile is not available
 ✓ src/utils/__tests__/analyze-results.spec.ts > unit:utils/analyzeResults > should return pretty printed build results
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > bundling > should enable bundling
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > bundling > should mark built-in modules as external
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > bundling > should support asset names
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > bundling > should support code splitting
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > plugins > should add dts if declarations are enabled
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > plugins > should add fully-specified if specifers require extensions
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > plugins > should add tsconfig-paths if tsconfig is detected
 ✓ src/utils/__tests__/esbuilder.integration.spec.ts > integration:utils/esbuilder > esbuild > transpiling > should disable bundling
 ✓ src/utils/__tests__/esbuilder.spec.ts > unit:utils/esbuilder > should return build result array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > should return empty array if code is empty string
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > export > should return declaration export statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > export > should return default export statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > export > should return named export statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > export > should return star export statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > export > should return type export statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > import > dynamic > should return dynamic import statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > import > static > should return default import statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > import > static > should return named import statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > require > should return require statement array
 ✓ src/utils/__tests__/extract-statements.spec.ts > unit:utils/extractStatements > require > should return require.resolve statement array
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > should return empty object is tsconfig is not found
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > should return empty object if user options are not found
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > should return user options
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > importsNotUsedAsValues > should convert "error" to ImportsNotUsedAsValues.Error
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > importsNotUsedAsValues > should convert "preserve" to ImportsNotUsedAsValues.Preserve
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > importsNotUsedAsValues > should convert "remove" to ImportsNotUsedAsValues.Remove
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > jsx > should convert "preserve" to JsxEmit.Preserve
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > jsx > should convert "react" to JsxEmit.React
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > jsx > should convert "react-jsx" to JsxEmit.ReactJSX
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > jsx > should convert "react-jsxdev" to JsxEmit.ReactJSXDev
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > jsx > should convert "react-native" to JsxEmit.ReactNative
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > lib > should convert libs into typescript library file names
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "amd" to ModuleKind.AMD
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "commonjs" to ModuleKind.CommonJS
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "es2015" to ModuleKind.ES2015
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "es2020" to ModuleKind.ES2020
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "es2022" to ModuleKind.ES2022
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "esnext" to ModuleKind.ESNext
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "node16" to ModuleKind.Node16
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "nodenext" to ModuleKind.NodeNext
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "none" to ModuleKind.None
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "system" to ModuleKind.System
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > module > should convert "umd" to ModuleKind.UMD
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleDetection > should convert "auto" to ModuleDetectionKind.Auto
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleDetection > should convert "force" to ModuleDetectionKind.Force
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleDetection > should convert "legacy" to ModuleDetectionKind.Legacy
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleResolution > should convert "classic" to ModuleResolutionKind.Classic
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleResolution > should convert "node" to ModuleResolutionKind.NodeJs
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleResolution > should convert "node16" to ModuleResolutionKind.Node16
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > moduleResolution > should convert "nodenext" to ModuleResolutionKind.NodeNext
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > newLine > should convert "crlf" to NewLineKind.CarriageReturnLineFeed
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > newLine > should convert "lf" to NewLineKind.LineFeed
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es3" to ScriptTarget.ES3
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es5" to ScriptTarget.ES5
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es2015" to ScriptTarget.ES2015
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es2016" to ScriptTarget.ES2016
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es20[17](https://github.com/flex-development/mkbuild/actions/runs/3124413376/jobs/5067747054#step:11:18)" to ScriptTarget.ES2017
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es20[18](https://github.com/flex-development/mkbuild/actions/runs/3124413376/jobs/5067747054#step:11:19)" to ScriptTarget.ES2018
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es20[19](https://github.com/flex-development/mkbuild/actions/runs/3124413376/jobs/5067747054#step:11:20)" to ScriptTarget.ES2019
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es[20](https://github.com/flex-development/mkbuild/actions/runs/3124413376/jobs/5067747054#step:11:21)20" to ScriptTarget.ES2020
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es2021" to ScriptTarget.ES2021
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "es2022" to ScriptTarget.ES2022
 ✓ src/utils/__tests__/get-compiler-options.spec.ts > unit:utils/getCompilerOptions > normalization > target > should convert "esnext" to ScriptTarget.ESNext
 ✓ src/utils/__tests__/loaders.spec.ts > unit:utils/loaders > should return esbuild loader config for esm transpilation
 ✓ src/utils/__tests__/loaders.spec.ts > unit:utils/loaders > should return esbuild loader config for esm bundle
 ✓ src/utils/__tests__/loaders.spec.ts > unit:utils/loaders > should return esbuild loader config for cjs bundle
 ✓ src/utils/__tests__/loaders.spec.ts > unit:utils/loaders > should return esbuild loader config for cjs transpilation
 ✓ src/utils/__tests__/write.functional.spec.ts > functional:utils/write > should write build result to file system
 ✓ src/utils/__tests__/write.spec.ts > unit:utils/write > should create subdirectories in output directory
 ✓ src/utils/__tests__/write.spec.ts > unit:utils/write > should write build result
 ✓ src/utils/__tests__/write.spec.ts > unit:utils/write > should return written build result

Test Files  20 passed (20)
     Tests  122 passed (122)
  Start at  01:15:02
  Duration  57.15s (transform 337ms, setup 5.24s, collect 2.54s, tests 28.40s)

 % Coverage report from c8
-----------------------------|---------|----------|---------|---------|-------------------
File                         | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
-----------------------------|---------|----------|---------|---------|-------------------
All files                    |     100 |      100 |     100 |     100 |                   
 src                         |     100 |      100 |     100 |     100 |                   
  make.ts                    |     100 |      100 |     100 |     100 |                   
 src/config                  |     100 |      100 |     100 |     100 |                   
  constants.ts               |     100 |      100 |     100 |     100 |                   
  define.ts                  |     100 |      100 |     100 |     100 |                   
  load.ts                    |     100 |      100 |     100 |     100 |                   
  loader-es.ts               |     100 |      100 |     100 |     100 |                   
 src/plugins/dts             |     100 |      100 |     100 |     100 |                   
  plugin.ts                  |     100 |      100 |     100 |     100 |                   
 src/plugins/fully-specified |     100 |      100 |     100 |     100 |                   
  plugin.ts                  |     100 |      100 |     100 |     100 |                   
 src/plugins/tsconfig-paths  |     100 |      100 |     100 |     100 |                   
  plugin.ts                  |     100 |      100 |     100 |     100 |                   
 src/utils                   |     100 |      100 |     100 |     100 |                   
  analyze-results.ts         |     100 |      100 |     100 |     100 |                   
  esbuilder.ts               |     100 |      100 |     100 |     100 |                   
  extract-statements.ts      |     100 |      100 |     100 |     100 |                   
  get-compiler-options.ts    |     100 |      100 |     100 |     100 |                   
  loaders.ts                 |     100 |      100 |     100 |     100 |                   
  write.ts                   |     100 |      100 |     100 |     100 |                   
-----------------------------|---------|----------|---------|---------|-------------------

`yarn build`

ℹ Building @flex-development/mkbuild                                                                21:16:16
✔ Build succeeded for @flex-development/mkbuild                                                     21:16:24
  dist (total size: 67.3 kB)                                                                        21:16:24
  └─ dist/index.mjs.map (177 B)
  └─ dist/index.mjs (288 B)
  └─ dist/index.d.mts (302 B)
  └─ dist/make.mjs.map (2.38 kB)
  └─ dist/make.mjs (3 kB)
  └─ dist/make.d.mts (744 B)
  └─ dist/config/constants.mjs.map (466 B)
  └─ dist/config/constants.mjs (777 B)
  └─ dist/config/constants.d.mts (1.15 kB)
  └─ dist/config/define.mjs.map (152 B)
  └─ dist/config/define.mjs (131 B)
  └─ dist/config/define.d.mts (385 B)
  └─ dist/config/load.mjs.map (514 B)
  └─ dist/config/load.mjs (639 B)
  └─ dist/config/load.d.mts (632 B)
  └─ dist/config/loader-es.mjs.map (726 B)
  └─ dist/config/loader-es.mjs (902 B)
  └─ dist/config/loader-es.d.mts (600 B)
  └─ dist/interfaces/config.mjs.map (69 B)
  └─ dist/interfaces/config.mjs (0 B)
  └─ dist/interfaces/config.d.mts (2.75 kB)
  └─ dist/interfaces/entry.mjs.map (69 B)
  └─ dist/interfaces/entry.mjs (0 B)
  └─ dist/interfaces/entry.d.mts (1.69 kB)
  └─ dist/interfaces/index.mjs.map (69 B)
  └─ dist/interfaces/index.mjs (0 B)
  └─ dist/interfaces/index.d.mts (340 B)
  └─ dist/interfaces/result.mjs.map (69 B)
  └─ dist/interfaces/result.mjs (0 B)
  └─ dist/interfaces/result.d.mts (1.23 kB)
  └─ dist/interfaces/source-file.mjs.map (69 B)
  └─ dist/interfaces/source-file.mjs (0 B)
  └─ dist/interfaces/source-file.d.mts (605 B)
  └─ dist/interfaces/statement.mjs.map (69 B)
  └─ dist/interfaces/statement.mjs (0 B)
  └─ dist/interfaces/statement.d.mts (686 B)
  └─ dist/types/esbuild-options.mjs.map (69 B)
  └─ dist/types/esbuild-options.mjs (0 B)
  └─ dist/types/esbuild-options.d.mts (468 B)
  └─ dist/types/index.mjs.map (69 B)
  └─ dist/types/index.mjs (0 B)
  └─ dist/types/index.d.mts (279 B)
  └─ dist/types/output-extension.mjs.map (69 B)
  └─ dist/types/output-extension.mjs (0 B)
  └─ dist/types/output-extension.d.mts (247 B)
  └─ dist/types/output-metadata.mjs.map (69 B)
  └─ dist/types/output-metadata.mjs (0 B)
  └─ dist/types/output-metadata.d.mts (267 B)
  └─ dist/utils/analyze-results.mjs.map (541 B)
  └─ dist/utils/analyze-results.mjs (575 B)
  └─ dist/utils/analyze-results.d.mts (577 B)
  └─ dist/utils/esbuilder.mjs.map (3.23 kB)
  └─ dist/utils/esbuilder.mjs (4.43 kB)
  └─ dist/utils/esbuilder.d.mts (736 B)
  └─ dist/utils/extract-statements.mjs.map (901 B)
  └─ dist/utils/extract-statements.mjs (1.1 kB)
  └─ dist/utils/extract-statements.d.mts (704 B)
  └─ dist/utils/get-compiler-options.mjs.map (2.6 kB)
  └─ dist/utils/get-compiler-options.mjs (5.36 kB)
  └─ dist/utils/get-compiler-options.d.mts (677 B)
  └─ dist/utils/loaders.mjs.map (671 B)
  └─ dist/utils/loaders.mjs (784 B)
  └─ dist/utils/loaders.d.mts (577 B)
  └─ dist/utils/write.mjs.map (282 B)
  └─ dist/utils/write.mjs (289 B)
  └─ dist/utils/write.d.mts (567 B)
  └─ dist/plugins/dts/plugin.mjs.map (2.49 kB)
  └─ dist/plugins/dts/plugin.mjs (3.93 kB)
  └─ dist/plugins/dts/plugin.d.mts (265 B)
  └─ dist/plugins/fully-specified/plugin.mjs.map (2.13 kB)
  └─ dist/plugins/fully-specified/plugin.mjs (3.32 kB)
  └─ dist/plugins/fully-specified/plugin.d.mts (1.56 kB)
  └─ dist/plugins/tsconfig-paths/options.mjs.map (69 B)
  └─ dist/plugins/tsconfig-paths/options.mjs (0 B)
  └─ dist/plugins/tsconfig-paths/options.d.mts (1.04 kB)
  └─ dist/plugins/tsconfig-paths/plugin.mjs.map (1.71 kB)
  └─ dist/plugins/tsconfig-paths/plugin.mjs (2.49 kB)
  └─ dist/plugins/tsconfig-paths/plugin.d.mts (507 B)
  dist (total size: 1.19 MB)                                                                        21:16:24
  └─ dist/cli.mjs.map (685 kB)
  └─ dist/cli.mjs (509 kB)
Σ Total build size: 1.26 MB                                                                         21:16:24

Linked issues

resolves 🔨 bundling #9

Additional context

dts plugin
- forbidden / overridden / unsupported tsconfig options
```
// remove forbidden user compiler options
delete compilerOptions.declarationDir
delete compilerOptions.out
delete compilerOptions.outFile
delete compilerOptions.rootDirs

// remove overridden user compiler options
delete compilerOptions.declaration
delete compilerOptions.emitDeclarationOnly
delete compilerOptions.noEmit
delete compilerOptions.noErrorTruncation
delete compilerOptions.outDir
delete compilerOptions.rootDir

// remove unsupported user compiler options
delete compilerOptions.declarationMap
delete compilerOptions.noEmitOnError
```
  - noEmitOnError: users are expected to run type check before building
    - diagnostics may be converted into esbuild warnings in a future update
- does not bundle declaration files yet (exits early when bundling is enabled)
  - Proposal: Bundling TS module type definitions microsoft/TypeScript#4433
    - this is listed on the typescript roadmap as "flattening declarations" 👀. it isn't scheduled yet, but it seems like it will be soon. holding off on a custom implementation / third party integration until further notice - native typescript support is definitely preferred 😌
  - both dts-bundle-generator and rollup-plugin-dts were considered for integration, but both libraries have issues that impact developer and/or user experience negatively

Submission checklist

self-review performed
tests added and/or updated
documentation added or updated
new, tolerable vulnerabilities and/or warnings documented, if any
pr naming conventions

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- pick loader based on `entry.bundle` and/or `entry.format` - https://esbuild.github.io/api/#loader Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://softwaretestinghelp.com/black-box-testing - https://softwaretestinghelp.com/white-box-testing-techniques-with-example Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://softwaretestinghelp.com/grey-box-testing-tutorial - https://softwaretestinghelp.com/white-box-testing-techniques-with-example - https://github.com/funny-bytes/chai-quantifiers Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-process-exit.md Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- majorly improves declaration file generation speed Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://esbuild.github.io/api/#outbase Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://esbuild.github.io/api/#entry-names Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://esbuild.github.io/api/#outbase Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- used to capture first letter before "js" or "ts" in output file extension Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

- https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler-API#getting-the-dts-from-a-javascript-file Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

flexdevelopment

lgtm 👍🏾

github-actions · 2023-03-31T00:58:43Z

This pull request has been automatically locked since there has not been any recent
activity after it was closed. Please open a new issue for related bugs or features. Be
sure to reference this issue.

unicornware added 30 commits September 17, 2022 17:03

refactor(interfaces): make Entry#declaration optional

5528412

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(interfaces): Entry#bundle?

005ea5e

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(interfaces): Entry#name?

121a2f2

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(utils): esbuild loader configuration

22e9afb

- pick loader based on `entry.bundle` and/or `entry.format` - https://esbuild.github.io/api/#loader Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(utils): loaders

1c7d659

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(utils): support esbuild bundling and code splitting options

f27b6b2

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(config): convert BUILTIN_MODULES from set to array

7e9062c

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(plugins): dts

59e7439

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(types): OutputExtension

74aa572

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(types): EsbuildOptions

35852e2

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(interfaces): Config#bundle?

019376f

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(interfaces): Config#ext?

4de5124

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(interfaces): Config#format?

3efeed3

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(interfaces): Config#source?

51af7e8

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor: pass esbuild options via build entries

9f4408d

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(plugins): error handling

baade1b

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

test(utils): [write] separate black box and white box techniques

ac3421e

- https://softwaretestinghelp.com/black-box-testing - https://softwaretestinghelp.com/white-box-testing-techniques-with-example Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(utils): buildSources

2182898

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

docs(utils): remove @todo comments from analyzeResults

a5d93a8

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

docs(utils): remove @todo comments from write

0621815

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

docs(utils): update analyzeResults description

a7d262e

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

docs(utils): update analyzeResults return description

1cd772c

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(utils): write signature

5bd6d05

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(config): default loadBuildConfig search location to '.'

f9acebf

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

style: prefer unicorn/no-process-exit over node/no-process-exit

85d4f50

- https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-process-exit.md Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(node): support bundling

16030df

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

build(cli): distribute cli as bundle

cea1e36

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

perf: build all source files at once

c8f2ce7

- majorly improves declaration file generation speed Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor: build entry normalization

579deb8

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

unicornware added 8 commits September 24, 2022 01:37

refactor: move default outbase logic to esbuilder

7ad78f8

- https://esbuild.github.io/api/#outbase Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(utils): [esbuilder] set entryNames

e87d99d

- https://esbuild.github.io/api/#entry-names Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(utils): [esbuilder] make bundle input relative to outbase

124b2e0

- https://esbuild.github.io/api/#outbase Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

test(plugins): check for esbuild errors and warnings

7f23271

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(plugins): [dts] respect user compiler options

6b7a37b

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

fix(plugins): [dts] onResolve filter does not match jsx or tsx

1dca7da

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(plugins): [dts] improve ext regex

f9b67b9

- used to capture first letter before "js" or "ts" in output file extension Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(options): only write dts files

00eb8ab

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

unicornware added scope:node node.js program type:task project tasks scope:esbuild esbuild integration labels Sep 25, 2022

unicornware self-assigned this Sep 25, 2022

unicornware linked an issue Sep 25, 2022 that may be closed by this pull request

🔨 bundling #9

Closed

24 tasks

unicornware added 3 commits September 24, 2022 22:14

chore(pkg): add check:types:build script

7c3c228

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

feat(utils): getCompilerOptions

558c8b8

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

refactor(plugins): [dts] normalize user compiler options

9bf57b1

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

unicornware marked this pull request as ready for review September 26, 2022 01:21

build(deps-peer): require at least typescript@3.7

850e830

- https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler-API#getting-the-dts-from-a-javascript-file Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

unicornware requested a review from flexdevelopment September 26, 2022 01:49

flexdevelopment approved these changes Sep 26, 2022

View reviewed changes

unicornware merged commit 10f79b5 into main Sep 26, 2022

unicornware deleted the feat/9-bundling branch September 26, 2022 01:56

github-actions bot locked as resolved and limited conversation to collaborators Mar 31, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: bundling #10

feat: bundling #10

unicornware commented Sep 25, 2022 •

edited

flexdevelopment left a comment

github-actions bot commented Mar 31, 2023

feat: bundling #10

feat: bundling #10

Conversation

unicornware commented Sep 25, 2022 • edited

Description

📦 Build

✨ Features

🏡 Housekeeping

🔥 Performance Improvements

⚡ Refactors

✅ Testing

Tests

yarn test:cov

yarn build

Linked issues

Related documents

Additional context

Submission checklist

flexdevelopment left a comment

Choose a reason for hiding this comment

github-actions bot commented Mar 31, 2023

unicornware commented Sep 25, 2022 •

edited

`yarn test:cov`

`yarn build`