@beforesemicolon/builder 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -39,6 +39,19 @@ Use another source directory when needed:
39
39
  await buildModules({ directoryPath: './source' })
40
40
  ```
41
41
 
42
+ Pass additional esbuild options through `esbuildOptions`. Builder continues to
43
+ own the source entries, output directories, module formats, and its required
44
+ plugins.
45
+
46
+ ```js
47
+ await buildModules({
48
+ esbuildOptions: {
49
+ keepNames: false,
50
+ target: 'es2022',
51
+ },
52
+ })
53
+ ```
54
+
42
55
  ## Build a browser bundle
43
56
 
44
57
  `buildBrowser` bundles a browser entry point with esbuild. It defaults to
@@ -59,6 +72,18 @@ await buildBrowser({
59
72
  })
60
73
  ```
61
74
 
75
+ Additional esbuild options can customize the browser build without replacing
76
+ its entry or output file. Custom plugins run after Builder's required plugin.
77
+
78
+ ```js
79
+ await buildBrowser({
80
+ esbuildOptions: {
81
+ keepNames: false,
82
+ sourcemap: false,
83
+ },
84
+ })
85
+ ```
86
+
62
87
  ## Migrating from Builder 1.x
63
88
 
64
89
  `buildDocs` and `src/docs` are intentionally absent from Builder 2.0. Replace
@@ -1 +1 @@
1
- "use strict";var a=Object.create;var n=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,y=Object.prototype.hasOwnProperty;var i=(e,r)=>n(e,"name",{value:r,configurable:!0});var g=(e,r)=>{for(var t in r)n(e,t,{get:r[t],enumerable:!0})},c=(e,r,t,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of d(r))!y.call(e,o)&&o!==t&&n(e,o,{get:()=>r[o],enumerable:!(s=m(r,o))||s.enumerable});return e};var p=(e,r,t)=>(t=e!=null?a(f(e)):{},c(r||!e||!e.__esModule?n(t,"default",{value:e,enumerable:!0}):t,e)),h=e=>c(n({},"__esModule",{value:!0}),e);var D={};g(D,{buildBrowser:()=>B});module.exports=h(D);var l=p(require("path"),1),u=p(require("esbuild"),1);const B=i(async({entry:e,out:r}={})=>{const t={name:"empty-parser-Doc-plugin",setup(s){s.onResolve({filter:/Doc$/},o=>{if(o.importer.includes("@beforesemicolon/html-parser"))return{path:o.path,namespace:"empty-Doc"}}),s.onLoad({filter:/.*/,namespace:"empty-Doc"},()=>({contents:""}))}};u.default.build({entryPoints:[e??l.default.resolve(process.cwd(),"src/client")],outfile:r??"dist/client.js",bundle:!0,keepNames:!0,sourcemap:!0,target:"esnext",minify:!0,plugins:[t]}).catch(console.error)},"buildBrowser");0&&(module.exports={buildBrowser});
1
+ "use strict";var y=Object.create;var i=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var O=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var u=(e,t)=>i(e,"name",{value:t,configurable:!0});var g=(e,t)=>{for(var r in t)i(e,r,{get:t[r],enumerable:!0})},l=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of f(t))!b.call(e,s)&&s!==r&&i(e,s,{get:()=>t[s],enumerable:!(o=B(t,s))||o.enumerable});return e};var c=(e,t,r)=>(r=e!=null?y(O(e)):{},l(t||!e||!e.__esModule?i(r,"default",{value:e,enumerable:!0}):r,e)),w=e=>l(i({},"__esModule",{value:!0}),e);var D={};g(D,{buildBrowser:()=>P});module.exports=w(D);var m=c(require("path"),1),d=c(require("esbuild"),1);const P=u(async({entry:e,out:t,esbuildOptions:r={}}={})=>{const o={name:"empty-parser-Doc-plugin",setup(n){n.onResolve({filter:/Doc$/},p=>{if(p.importer.includes("@beforesemicolon/html-parser"))return{path:p.path,namespace:"empty-Doc"}}),n.onLoad({filter:/.*/,namespace:"empty-Doc"},()=>({contents:""}))}},{plugins:s=[],...a}=r;return d.default.build({bundle:!0,keepNames:!0,sourcemap:!0,target:"esnext",minify:!0,...a,entryPoints:[e??m.default.resolve(process.cwd(),"src/client")],outfile:t??"dist/client.js",plugins:[o,...s]})},"buildBrowser");0&&(module.exports={buildBrowser});
@@ -1 +1 @@
1
- "use strict";var g=Object.create;var n=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var o=(t,s)=>n(t,"name",{value:s,configurable:!0});var h=(t,s)=>{for(var e in s)n(t,e,{get:s[e],enumerable:!0})},p=(t,s,e,r)=>{if(s&&typeof s=="object"||typeof s=="function")for(let i of j(s))!b.call(t,i)&&i!==e&&n(t,i,{get:()=>s[i],enumerable:!(r=y(s,i))||r.enumerable});return t};var u=(t,s,e)=>(e=t!=null?g(x(t)):{},p(s||!t||!t.__esModule?n(e,"default",{value:t,enumerable:!0}):e,t)),P=t=>p(n({},"__esModule",{value:!0}),t);var F={};h(F,{buildModules:()=>E});module.exports=P(F);var l=u(require("esbuild"),1),d=u(require("path"),1),a=u(require("fs"),1),m=require("@gjsify/esbuild-plugin-transform-ext");function B(t){const s=[];function e(r){const i=a.default.readdirSync(r,{withFileTypes:!0});for(const f of i){const c=d.default.join(r,f.name);f.isDirectory()?e(c):s.push(c)}}return o(e,"readDirectory"),e(t),s}o(B,"readFilesRecursively");async function E({directoryPath:t}={}){t=t??d.default.join(process.cwd(),"src");const s=B(t).filter(e=>/\.(t|j)s$/.test(e)&&!e.endsWith(".spec.ts")&&!e.endsWith("/client.ts"));return Promise.all([l.default.build({entryPoints:s,outdir:"dist/esm",target:"esnext",minify:!0,format:"esm",platform:"node",keepNames:!0,plugins:[(0,m.transformExtPlugin)({outExtension:{".ts":".js"}})]}),l.default.build({entryPoints:s,outdir:"dist/cjs",target:"esnext",minify:!0,format:"cjs",platform:"node",keepNames:!0,plugins:[(0,m.transformExtPlugin)({outExtension:{".ts":".js"}})]})])}o(E,"buildModules");0&&(module.exports={buildModules});
1
+ "use strict";var y=Object.create;var u=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,O=Object.prototype.hasOwnProperty;var l=(t,s)=>u(t,"name",{value:s,configurable:!0});var j=(t,s)=>{for(var i in s)u(t,i,{get:s[i],enumerable:!0})},f=(t,s,i,o)=>{if(s&&typeof s=="object"||typeof s=="function")for(let e of b(s))!O.call(t,e)&&e!==i&&u(t,e,{get:()=>s[e],enumerable:!(o=g(s,e))||o.enumerable});return t};var d=(t,s,i)=>(i=t!=null?y(x(t)):{},f(s||!t||!t.__esModule?u(i,"default",{value:t,enumerable:!0}):i,t)),P=t=>f(u({},"__esModule",{value:!0}),t);var E={};j(E,{buildModules:()=>B});module.exports=P(E);var p=d(require("esbuild"),1),c=d(require("path"),1),a=d(require("fs"),1),m=require("@gjsify/esbuild-plugin-transform-ext");function h(t){const s=[];function i(o){const e=a.default.readdirSync(o,{withFileTypes:!0});for(const n of e){const r=c.default.join(o,n.name);n.isDirectory()?i(r):s.push(r)}}return l(i,"readDirectory"),i(t),s}l(h,"readFilesRecursively");async function B({directoryPath:t,esbuildOptions:s={}}={}){const i=t??c.default.join(process.cwd(),"src"),o=h(i).filter(r=>/\.(t|j)s$/.test(r)&&!r.endsWith(".spec.ts")&&!r.endsWith("/client.ts")),{plugins:e=[],...n}=s;return Promise.all([p.default.build({target:"esnext",minify:!0,platform:"node",keepNames:!0,...n,entryPoints:o,outdir:"dist/esm",format:"esm",plugins:[(0,m.transformExtPlugin)({outExtension:{".ts":".js"}}),...e]}),p.default.build({target:"esnext",minify:!0,platform:"node",keepNames:!0,...n,entryPoints:o,outdir:"dist/cjs",format:"cjs",plugins:[(0,m.transformExtPlugin)({outExtension:{".ts":".js"}}),...e]})])}l(B,"buildModules");0&&(module.exports={buildModules});
@@ -1 +1 @@
1
- var i=Object.defineProperty;var s=(e,r)=>i(e,"name",{value:r,configurable:!0});import c from"path";import p from"esbuild";const d=s(async({entry:e,out:r}={})=>{const n={name:"empty-parser-Doc-plugin",setup(t){t.onResolve({filter:/Doc$/},o=>{if(o.importer.includes("@beforesemicolon/html-parser"))return{path:o.path,namespace:"empty-Doc"}}),t.onLoad({filter:/.*/,namespace:"empty-Doc"},()=>({contents:""}))}};p.build({entryPoints:[e??c.resolve(process.cwd(),"src/client")],outfile:r??"dist/client.js",bundle:!0,keepNames:!0,sourcemap:!0,target:"esnext",minify:!0,plugins:[n]}).catch(console.error)},"buildBrowser");export{d as buildBrowser};
1
+ var l=Object.defineProperty;var i=(e,t)=>l(e,"name",{value:t,configurable:!0});import c from"path";import m from"esbuild";const B=i(async({entry:e,out:t,esbuildOptions:o={}}={})=>{const n={name:"empty-parser-Doc-plugin",setup(r){r.onResolve({filter:/Doc$/},s=>{if(s.importer.includes("@beforesemicolon/html-parser"))return{path:s.path,namespace:"empty-Doc"}}),r.onLoad({filter:/.*/,namespace:"empty-Doc"},()=>({contents:""}))}},{plugins:p=[],...u}=o;return m.build({bundle:!0,keepNames:!0,sourcemap:!0,target:"esnext",minify:!0,...u,entryPoints:[e??c.resolve(process.cwd(),"src/client")],outfile:t??"dist/client.js",plugins:[n,...p]})},"buildBrowser");export{B as buildBrowser};
@@ -1 +1 @@
1
- var f=Object.defineProperty;var i=(t,s)=>f(t,"name",{value:s,configurable:!0});import u from"esbuild";import l from"path";import c from"fs";import{transformExtPlugin as d}from"@gjsify/esbuild-plugin-transform-ext";function p(t){const s=[];function e(r){const m=c.readdirSync(r,{withFileTypes:!0});for(const n of m){const o=l.join(r,n.name);n.isDirectory()?e(o):s.push(o)}}return i(e,"readDirectory"),e(t),s}i(p,"readFilesRecursively");async function b({directoryPath:t}={}){t=t??l.join(process.cwd(),"src");const s=p(t).filter(e=>/\.(t|j)s$/.test(e)&&!e.endsWith(".spec.ts")&&!e.endsWith("/client.ts"));return Promise.all([u.build({entryPoints:s,outdir:"dist/esm",target:"esnext",minify:!0,format:"esm",platform:"node",keepNames:!0,plugins:[d({outExtension:{".ts":".js"}})]}),u.build({entryPoints:s,outdir:"dist/cjs",target:"esnext",minify:!0,format:"cjs",platform:"node",keepNames:!0,plugins:[d({outExtension:{".ts":".js"}})]})])}i(b,"buildModules");export{b as buildModules};
1
+ var c=Object.defineProperty;var u=(i,t)=>c(i,"name",{value:t,configurable:!0});import l from"esbuild";import d from"path";import m from"fs";import{transformExtPlugin as p}from"@gjsify/esbuild-plugin-transform-ext";function f(i){const t=[];function r(e){const n=m.readdirSync(e,{withFileTypes:!0});for(const o of n){const s=d.join(e,o.name);o.isDirectory()?r(s):t.push(s)}}return u(r,"readDirectory"),r(i),t}u(f,"readFilesRecursively");async function O({directoryPath:i,esbuildOptions:t={}}={}){const r=i??d.join(process.cwd(),"src"),e=f(r).filter(s=>/\.(t|j)s$/.test(s)&&!s.endsWith(".spec.ts")&&!s.endsWith("/client.ts")),{plugins:n=[],...o}=t;return Promise.all([l.build({target:"esnext",minify:!0,platform:"node",keepNames:!0,...o,entryPoints:e,outdir:"dist/esm",format:"esm",plugins:[p({outExtension:{".ts":".js"}}),...n]}),l.build({target:"esnext",minify:!0,platform:"node",keepNames:!0,...o,entryPoints:e,outdir:"dist/cjs",format:"cjs",plugins:[p({outExtension:{".ts":".js"}}),...n]})])}u(O,"buildModules");export{O as buildModules};
@@ -1,6 +1,8 @@
1
- interface BuildBrowserOptions {
1
+ import { type BuildOptions, type BuildResult } from 'esbuild';
2
+ export type BrowserEsbuildOptions = Omit<BuildOptions, 'entryPoints' | 'stdin' | 'outfile' | 'outdir'>;
3
+ export interface BuildBrowserOptions {
2
4
  entry?: string;
3
5
  out?: string;
6
+ esbuildOptions?: BrowserEsbuildOptions;
4
7
  }
5
- export declare const buildBrowser: ({ entry, out, }?: BuildBrowserOptions) => Promise<void>;
6
- export {};
8
+ export declare const buildBrowser: ({ entry, out, esbuildOptions, }?: BuildBrowserOptions) => Promise<BuildResult>;
@@ -1,5 +1,7 @@
1
- import esbuild from 'esbuild';
1
+ import esbuild, { type BuildOptions } from 'esbuild';
2
+ export type ModuleEsbuildOptions = Omit<BuildOptions, 'entryPoints' | 'stdin' | 'outfile' | 'outdir' | 'format'>;
2
3
  export interface BuildModulesOptions {
3
4
  directoryPath?: string;
5
+ esbuildOptions?: ModuleEsbuildOptions;
4
6
  }
5
- export declare function buildModules({ directoryPath, }?: BuildModulesOptions): Promise<esbuild.BuildResult[]>;
7
+ export declare function buildModules({ directoryPath, esbuildOptions, }?: BuildModulesOptions): Promise<esbuild.BuildResult[]>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@beforesemicolon/builder",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
4
4
  "description": "Utilities for building npm packages for modules and browsers",
5
5
  "engines": {
6
6
  "node": ">=18.16.0"