bun_bun_bundle 0.9.1 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32717f75c661fee2dfaaec58b6a41c6af8c10e29b44a10c193a9d7f953a28ce8
-  data.tar.gz: 827508488f3c5e7e212c832570e904bd1072a9b595e5a2c6675b01774fc1462f
+  metadata.gz: d45723ba4d7826f7a860af793c4acf6fbceda366e442f9b9858ec2c1f340e5ec
+  data.tar.gz: 13a119627c68cd7009975c40e0caa22f91adc35797b74f7604c35237960a69c8
 SHA512:
-  metadata.gz: 12ec0f0fe4952c46718f33f3a4599c6056222948d452e800e1015219d58332be31241d49bf62111e372dcdeff163dd6a9b0cc68c1001f0545490ba64a4de5106
-  data.tar.gz: fb6875aae889f86d030905721b74eeca6b293684c8076577728f1f2bc00002763d7cc6e35d2dc3522494526194c28d09d7dd92cdc4d3ec528d1fe0c1773bfa89
+  metadata.gz: 7e7f845bfaff50c0c3a3b18e5dfcac5900929d9d2f261b3931a5bbac47775629d77a834c9e581a6c0dbea04004cbfd4d7a561a7d013524a55a67837e5b3cf42a
+  data.tar.gz: 3d17dbcfe26e03538d349bb2a8ba48ec5ecd52b203712ab0296ebaa4502485c7b4275e0a4cfd8764a1d8e6dd2cb56651430ed42ac05c621151d807439eb54e11

data/README.md

@@ -174,13 +174,30 @@ bun_bun_bundle dev
 # Build assets
 bun_bun_bundle build
 
-# Build with fingerprinting and minification
+# Build with fingerprinting and minification (shortcut)
 bun_bun_bundle build --prod
 
+# Fingerprint without minifying (e.g. for staging diagnostics)
+bun_bun_bundle build --fingerprint
+
+# Strip sourcemaps from a prod build
+bun_bun_bundle build --prod --sourcemap=none
+
 # Development with verbose WebSocket logging
 bun_bun_bundle dev --debug
 ```
 
+### Flags
+
+- `--prod`: shortcut for `--fingerprint --minify`
+- `--fingerprint`: hash asset filenames for cache busting
+- `--minify`: minify JS and CSS output
+- `--sourcemap[=KIND]`: `inline`, `linked`, `external`, or `none`. Defaults
+  to `inline` in `dev` and `linked` for builds, so production stack traces
+  and browser devtools stay debuggable. Pass `--sourcemap=none` when you
+  explicitly do not want maps shipped.
+- `--debug`: verbose WebSocket logging
+
 > [!NOTE]
 > When running from a Procfile (e.g. with Overmind or Foreman), use
 > `bundle exec bun_bun_bundle` to ensure the correct gem version is loaded.
@@ -320,7 +337,11 @@ The context object has the following properties:
 - `root`: absolute path to the project root
 - `config`: the resolved `bun.json` configuration object
 - `dev`: `true` when running in development mode
-- `prod`: `true` when running in production mode
+- `prod`: `true` when `--prod` was passed (shortcut flag)
+- `fingerprint`: `true` when asset filenames will be content-hashed
+- `minify`: `true` when output will be minified (use this to strip
+  comments, banners, or dev-only branches in your plugin)
+- `sourcemap`: the sourcemap kind being produced (or `null` for default)
 - `manifest`: the current asset manifest object
 
 #### Simple transform plugins
@@ -337,9 +358,9 @@ transform receives the output of the previous one.
 ```javascript
 // config/bun/banner.js
 
-export default function banner({prod}) {
+export default function banner({minify}) {
   return (content, args) => {
-    const stamp = prod ? '' : ` (dev ${args.path})`
+    const stamp = minify ? '' : ` (dev ${args.path})`
     return `/* My App${stamp} */\n${content}`
   }
 }

data/exe/bun_bun_bundle

@@ -22,13 +22,19 @@ else
       build   Build assets
 
     Flags:
-      --prod   Enable minification and fingerprinting
-      --debug  Enable verbose WebSocket logging
+      --prod              Shortcut for --fingerprint --minify
+      --fingerprint       Hash asset filenames for cache busting
+      --minify            Minify JS and CSS output
+      --sourcemap[=KIND]  Sourcemap kind: inline, linked, external, none
+                          (dev defaults to inline, builds default to linked)
+      --debug             Enable verbose WebSocket logging
 
     Examples:
-      bun_bun_bundle dev              # development with live reload
-      bun_bun_bundle build            # build assets
-      bun_bun_bundle build --prod     # build with fingerprinting and minification
+      bun_bun_bundle dev                            # live reload
+      bun_bun_bundle build                          # plain build
+      bun_bun_bundle build --prod                   # fingerprint + minify
+      bun_bun_bundle build --fingerprint            # fingerprint only
+      bun_bun_bundle build --prod --sourcemap=none  # strip sourcemaps
 
     Configuration:
       Place a config/bun.json in your project root to customize settings.

data/lib/bun/bake.js

@@ -1,9 +1,5 @@
 import BunBunBundle from "./bun_bundle.js";
 
-BunBunBundle.flags({
-  debug: process.argv.includes("--debug"),
-  dev: process.argv.includes("--dev"),
-  prod: process.argv.includes("--prod"),
-});
+BunBunBundle.flags(process.argv);
 
 await BunBunBundle.bake();

data/lib/bun/bun_bundle.js

@@ -21,14 +21,50 @@ export default {
   debug: false,
   dev: false,
   prod: false,
+  fingerprint: false,
+  minify: false,
+  sourcemap: null,
   wsClients: new Set(),
   watchTimers: new Map(),
   plugins: [],
 
-  flags({debug, dev, prod}) {
+  flags(input) {
+    const {debug, dev, prod, fingerprint, minify, sourcemap} = Array.isArray(
+      input
+    )
+      ? this.parseArgv(input)
+      : input
     if (debug != null) this.debug = debug
     if (dev != null) this.dev = dev
     if (prod != null) this.prod = prod
+    if (fingerprint != null) this.fingerprint = fingerprint
+    else if (prod === true) this.fingerprint = true
+    if (minify != null) this.minify = minify
+    else if (prod === true) this.minify = true
+    if (sourcemap != null) this.sourcemap = sourcemap
+  },
+
+  SOURCEMAP_KINDS: ['inline', 'linked', 'external', 'none'],
+
+  parseArgv(argv) {
+    const opts = {}
+    if (argv.includes('--debug')) opts.debug = true
+    if (argv.includes('--dev')) opts.dev = true
+    if (argv.includes('--prod')) opts.prod = true
+    if (argv.includes('--fingerprint')) opts.fingerprint = true
+    if (argv.includes('--minify')) opts.minify = true
+    const sm = argv.find(
+      a => a === '--sourcemap' || a.startsWith('--sourcemap=')
+    )
+    if (sm) {
+      const value = sm.includes('=') ? sm.split('=')[1] : 'linked'
+      if (this.SOURCEMAP_KINDS.includes(value)) opts.sourcemap = value
+      else
+        console.warn(
+          ` ▸ Ignoring --sourcemap=${value} (valid: ${this.SOURCEMAP_KINDS.join(', ')})`
+        )
+    }
+    return opts
   },
 
   deepMerge(target, source) {
@@ -43,7 +79,10 @@ export default {
 
   loadConfig() {
     const defaults = {
-      entryPoints: {js: ['app/assets/js/app.js'], css: ['app/assets/css/app.css']},
+      entryPoints: {
+        js: ['app/assets/js/app.js'],
+        css: ['app/assets/css/app.css']
+      },
       plugins: {css: ['aliases', 'cssGlobs'], js: ['aliases', 'jsGlobs']},
       watchDirs: ['app/assets'],
       staticDirs: ['app/assets/images', 'app/assets/fonts'],
@@ -69,6 +108,9 @@ export default {
       config: this.config,
       dev: this.dev,
       prod: this.prod,
+      fingerprint: this.fingerprint,
+      minify: this.minify,
+      sourcemap: this.sourcemap,
       manifest: this.manifest
     })
   },
@@ -79,8 +121,8 @@ export default {
     return join(this.root, this.config.outDir)
   },
 
-  fingerprint(name, ext, content) {
-    if (!this.prod) return `${name}${ext}`
+  fingerprintName(name, ext, content) {
+    if (!this.fingerprint) return `${name}${ext}`
 
     const hash = Bun.hash(content).toString(16).slice(0, 8)
     return `${name}-${hash}${ext}`
@@ -107,7 +149,7 @@ export default {
       try {
         result = await Bun.build({
           entrypoints: [entryPath],
-          minify: this.prod,
+          minify: this.minify,
           plugins: this.plugins,
           ...options
         })
@@ -124,16 +166,26 @@ export default {
         continue
       }
 
-      const output = result.outputs.find(o => o.path.endsWith(ext))
-      if (!output) {
+      const mainOutput = result.outputs.find(o => o.path.endsWith(ext))
+      if (!mainOutput) {
         console.error(` ▸ No ${type.toUpperCase()} output for ${entry}`)
         continue
       }
+      const mapOutput = result.outputs.find(o => o.kind === 'sourcemap')
+
+      let content = await mainOutput.text()
+      const fileName = this.fingerprintName(entryName, ext, content)
+
+      if (mapOutput) {
+        const mapFileName = `${fileName}.map`
+        content = content.replace(
+          /\/\/# sourceMappingURL=\S+/,
+          () => `//# sourceMappingURL=${mapFileName}`
+        )
+        await Bun.write(join(outDir, mapFileName), await mapOutput.text())
+      }
 
-      const content = await output.text()
-      const fileName = this.fingerprint(entryName, ext, content)
       await Bun.write(join(outDir, fileName), content)
-
       this.manifest[`${type}/${entryName}${ext}`] = `${type}/${fileName}`
     }
   },
@@ -142,7 +194,7 @@ export default {
     await this.buildAssets('js', {
       target: 'browser',
       format: 'iife',
-      sourcemap: this.dev ? 'inline' : 'none'
+      sourcemap: this.sourcemap || (this.dev ? 'inline' : 'linked')
     })
   },
 
@@ -166,7 +218,11 @@ export default {
 
         const ext = extname(file)
         const name = file.slice(0, -ext.length) || file
-        const fileName = this.fingerprint(name, ext, new Uint8Array(content))
+        const fileName = this.fingerprintName(
+          name,
+          ext,
+          new Uint8Array(content)
+        )
         const destPath = join(destDir, fileName)
 
         mkdirSync(dirname(destPath), {recursive: true})
@@ -223,6 +279,10 @@ export default {
   },
 
   async watch() {
+    const extras = this.config.watchExtensions || {}
+    const cssExts = ['css', ...(extras.css || [])]
+    const jsExts = ['js', 'ts', 'jsx', 'tsx', ...(extras.js || [])]
+
     const handler = (event, filename) => {
       if (!filename) return
 
@@ -239,16 +299,18 @@ export default {
 
       // Debounce: multiple events for the same file (e.g. actual save + backup)
       if (this.watchTimers.has(normalizedFilename)) return
-      this.watchTimers.set(normalizedFilename, setTimeout(() => {
-        this.watchTimers.delete(normalizedFilename)
-      }, 100))
+      this.watchTimers.set(
+        normalizedFilename,
+        setTimeout(() => {
+          this.watchTimers.delete(normalizedFilename)
+        }, 100)
+      )
 
       console.log(` ▸ ${normalizedFilename} changed`)
-
       ;(async () => {
         try {
-          if (ext === 'css') await this.buildCSS()
-          else if (['js', 'ts', 'jsx', 'tsx'].includes(ext)) await this.buildJS()
+          if (cssExts.includes(ext)) await this.buildCSS()
+          else if (jsExts.includes(ext)) await this.buildJS()
           else if (base.includes('.')) await this.copyStaticAssets()
 
           await this.writeManifest()
@@ -295,7 +357,8 @@ export default {
         },
         close(ws) {
           wsClients.delete(ws)
-          if (debug) console.log(` ▸ Client disconnected (${wsClients.size})\n\n`)
+          if (debug)
+            console.log(` ▸ Client disconnected (${wsClients.size})\n\n`)
         },
         message() {}
       }

data/lib/bun/plugins/aliases.js

@@ -1,9 +1,14 @@
-const REGEX = /(url\(\s*['"]?|(?<!\w)['"](?:glob:)?)\$\//g
+const CSS_REGEX = /((?:url\(\s*|@import\s+)['"]?(?:glob:)?)\$\//g
+const JS_REGEX =
+  /((?:from\s+|require\s*\(\s*|import\s*\(\s*)['"](?:glob:)?)\$\//g
 
 // Resolves `$/` root aliases in CSS url() references and JS/CSS imports.
 // e.g. url('$/app/assets/images/foo.png') → url('/absolute/root/app/assets/images/foo.png')
 //      import x from '$/lib/utils.js' → import x from '/absolute/root/lib/utils.js'
 //      @import '$/app/assets/css/reset.css' → @import '/absolute/root/app/assets/css/reset.css'
 export default function aliases({root}) {
-  return content => content.replace(REGEX, `$1${root}/`)
+  return (content, args) => {
+    const regex = args.path.endsWith('.css') ? CSS_REGEX : JS_REGEX
+    return content.replace(regex, `$1${root}/`)
+  }
 }

data/lib/bun_bun_bundle/reload_tag.rb

@@ -33,6 +33,19 @@ module BunBunBundle
           const ws = new WebSocket('#{config.dev_server.ws_url}')
           let connected = false
 
+          const scrollKey = 'bun-scroll:' + location.pathname
+          addEventListener('load', () => {
+            const saved = sessionStorage.getItem(scrollKey)
+            if (saved !== null) {
+              sessionStorage.removeItem(scrollKey)
+              scrollTo(0, parseInt(saved, 10))
+            }
+          })
+          const reload = () => {
+            sessionStorage.setItem(scrollKey, String(scrollY))
+            location.reload()
+          }
+
           ws.onmessage = (event) => {
             const data = JSON.parse(event.data)
 
@@ -50,7 +63,7 @@ module BunBunBundle
               console.error('\\u2716 Build error:', data.message)
             } else {
               console.log('\\u25b8 Reloading...')
-              location.reload()
+              reload()
             }
           }
 
@@ -59,7 +72,7 @@ module BunBunBundle
             console.log('\\u25b8 Live reload connected')
           }
           ws.onclose = () => {
-            if (connected) setTimeout(() => location.reload(), 2000)
+            if (connected) setTimeout(reload, 2000)
           }
         })()
         </script>

data/lib/bun_bun_bundle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BunBunBundle
-  VERSION = '0.9.1'
+  VERSION = '0.11.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bun_bun_bundle
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.11.0
 platform: ruby
 authors:
 - Wout Fierens