bun_bun_bundle 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53f72b01034723b063b04b4df86acc094b5a84011418ece1c605395f7f181f07
-  data.tar.gz: a4a1f55347278d192046055421f321d6efb527260a8ea61ff443cc2f178eed86
+  metadata.gz: 29e412dc1eeee94ba33c0f47186a649d6a8843b2a4edaf01cf7b72e7f66b29c2
+  data.tar.gz: 3744a8ccad103452e0099c6cb8e5bae65ed7a8c4eeb820cad2d52e8accb9384f
 SHA512:
-  metadata.gz: 9f70bcf0c97a16e5e8338b32336cebbc410960cf105dcae30bce119ee679c9f9b26b882a88792fb9ae73ebb1de5659de24ba1d38f772271edfe17082b44a02f6
-  data.tar.gz: 934a76e20b22cb83f947f43c0fa05080000e8b74141a699031f3b8d151625c7874139971c14f8b96952b852e8d2167ce4931de83ba3a7716899601023b310fee
+  metadata.gz: 9d9e25a4d96f7a17e5231fdb211e01a231114dc6a3cec1c4c29373ed153896943abb13f5b518c954259d39ffd5d6985058323fa95d9125c1baa8bd4fb8c309e2
+  data.tar.gz: 16530cfc8cbbf16e2f56874b9697fcb0b41aa3aa83266116672f516b9778768b0836886a9456dd24c0dae3b1653e6059290b74a7150e5673400c4847653d9afc

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,42 @@ 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) {
@@ -69,6 +97,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 +110,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 +138,7 @@ export default {
       try {
         result = await Bun.build({
           entrypoints: [entryPath],
-          minify: this.prod,
+          minify: this.minify,
           plugins: this.plugins,
           ...options
         })
@@ -124,16 +155,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 +183,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 +207,7 @@ 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})

data/lib/bun/plugins/jsGlobs.js

@@ -1,4 +1,4 @@
-import {dirname, extname} from 'path'
+import {dirname, extname, isAbsolute, relative, join} from 'path'
 import {Glob} from 'bun'
 
 const REGEX = /import\s+(\w+)\s+from\s+['"]glob:([^'"]+)['"]/g
@@ -20,24 +20,46 @@ function excluded(file, matchers) {
 
 function scanFiles(dir, pattern, excludes) {
   const {clean, base} = splitBase(pattern)
-  const matchers = excludes.map(e => new Glob(e.replace(/^\.\//, '')))
-  const glob = new Glob(clean)
-  return Array.from(glob.scanSync({cwd: dir}))
-    .filter(f => !excluded(f, matchers))
-    .sort()
+  const abs = isAbsolute(clean)
+  const cwd = abs ? base : dir
+  const globPart = abs ? clean.slice(base.length + 1) : clean
+  const matchers = excludes.map(e => {
+    const ex = e.replace(/^\.\//, '')
+    return new Glob(abs && isAbsolute(ex) ? ex.slice(base.length + 1) : ex)
+  })
+  const glob = new Glob(globPart)
+  const files = []
+
+  for (const file of glob.scanSync({cwd})) {
+    if (excluded(file, matchers)) continue
+    const absPath = join(cwd, file)
+    const rel = relative(dir, absPath)
+    files.push(rel)
+  }
+
+  return files.sort()
+}
+
+function keyBase(pattern) {
+  const {base} = splitBase(pattern)
+  if (!isAbsolute(base)) return base
+  const last = base.lastIndexOf('/')
+  return last > 0 ? base.slice(last + 1) : base
 }
 
-function buildImportMap(files, base) {
+function buildImportMap(files, dir, base) {
   const imports = []
   const entries = []
 
   for (const file of files) {
     const ext = extname(file)
-    const rel = base ? file.slice(base.length + 1) : file
-    const key = rel.slice(0, -ext.length)
-    const prefix = base ? `${base}_` : ''
-    const safe = `_glob_${prefix}${key}`.replace(/[^a-zA-Z0-9]/g, '_')
-    imports.push(`import ${safe} from './${file}'`)
+    const key = file
+      .slice(0, -ext.length)
+      .replace(/^[./]+/, '')
+      .replace(new RegExp(`^.*${base}/`), '')
+    const safe = `_glob_${base}_${key}`.replace(/[^a-zA-Z0-9]/g, '_')
+    const rel = file.startsWith('.') ? file : `./${file}`
+    imports.push(`import ${safe} from '${rel}'`)
     entries.push(`  '${key}': ${safe}`)
   }
 
@@ -48,13 +70,13 @@ export default function jsGlobs() {
   return (content, args) => {
     return content.replace(REGEX, (_, binding, raw) => {
       const {pattern, excludes} = parseImport(raw)
-      const {base} = splitBase(pattern)
+      const base = keyBase(pattern)
       const dir = dirname(args.path)
       const files = scanFiles(dir, pattern, excludes)
 
       if (!files.length) return `const ${binding} = {}`
 
-      const {imports, entries} = buildImportMap(files, base)
+      const {imports, entries} = buildImportMap(files, dir, base)
 
       return [
         ...imports,

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.0'
+  VERSION = '0.10.0'
 end

metadata

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