@tmbr/bundler 1.11.0 → 1.12.1

package/README.md

@@ -1,6 +1,6 @@
 # TMBR Bundler
 
-A configurable JavaScript and [SASS](https://sass-lang.com/documentation/) bundler built on [esbuild](https://esbuild.github.io) and [browser-sync](https://browsersync.io). Intended for WordPress development or projects where a CI/CD workflow is not available, allowing for concurrent development and production bundles.
+A configurable JavaScript and SASS bundler built on [esbuild](https://esbuild.github.io) and [browser-sync](https://browsersync.io). Intended for WordPress development or projects where a CI/CD workflow is not available, allowing for concurrent development and production bundles.
 
 **Why [esbuild](https://esbuild.github.io)?**
 
@@ -9,11 +9,11 @@ Compared to the mess of webpack loaders and dependencies, esbuild is faster, has
 ## Installation
 
 ```bash
-npm install --save-dev @tmbr/bundler
+npm install -D @tmbr/bundler
 ```
 
 ## Usage
-`@tmbr/bundler` has two commands - `build` and `watch` - that both create concurrent builds:
+`@tmbr/bundler` has two commands - `build` and `watch` - that both create concurrent bundles:
 - `build/main.dev.[css|js]` development version with sourcemaps
 - `build/main.min.[css|js]` minified production version
 
@@ -26,6 +26,29 @@ This command creates the build files noted above and displays KB sizes for the m
 This command will create initial build files noted above and start watching for changes. By default, it will look at the **name** field in your `package.json` file, append `.test` and proxy
 `http://example.test:3000` for auto-reloading.
 
+![Watch command example](./screenshot.png)
+
 ## Configuration
 
-More information coming soon!
+A second argument can be passed after `build` or `watch` to allow for overriding the default options. This should be a relative path to a file that includes named exports for build, watch and / or serve. If an export returns an object, it will be shallow merged into the bundler's options. Alternatively, an exported function will receive the default options and expect a returned object.
+
+`bundler watch bundler.config.js`<br>`bundler build bundler.config.js`
+
+### Examples
+
+#### Change output directory
+```js
+export const build = {
+  outdir: 'dist'
+};
+
+export const watch = {
+  outdir: 'dist'
+};
+```
+
+#### Change [browser-sync](https://browsersync.io/docs/options) options
+```js
+export const serve = {
+  port: 5000
+};

package/cli.js

@@ -34,7 +34,7 @@ const logger = (options = {}) => ({
 
       if (result.warnings.length || result.errors.length) {
         console.log('\x07');
-        return
+        return;
       }
 
       const css = `${path}/${slug}.css`;
@@ -59,6 +59,11 @@ const buildOptions = {
   sourcemap: false,
   treeShaking: true,
   legalComments: 'none',
+  loader: {
+    '.glsl': 'text',
+    '.vert': 'text',
+    '.frag': 'text',
+  },
   plugins: [
     styles({sourceMap: false, logger: sass.Logger.silent}),
     logger()
@@ -77,7 +82,7 @@ const watchOptions = Object.assign({}, buildOptions, {
 
 const serveOptions = {
   proxy: `${process.env.npm_package_name}.test`,
-  files: ['assets/**', 'build/*', '**/*.php'],
+  files: ['assets/**', 'build/*', '**/*.php', '**/*.html'],
   host: 'localhost',
   open: false,
   notify: false,

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@tmbr/bundler",
   "type": "module",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "repository": "github:TMBR/tmbr-bundler",
   "bin": {
     "bundler": "cli.js",
     "tmbr-bundler": "cli.js"
   },
   "dependencies": {
-    "browser-sync": "^3.0.2",
-    "chalk": "^5.3.0",
-    "esbuild": "^0.19.11",
-    "esbuild-sass-plugin": "^2.16.1"
+    "browser-sync": "^3.0.3",
+    "chalk": "^5.4.1",
+    "esbuild": "^0.25.0",
+    "esbuild-sass-plugin": "^3.3.1"
   }
 }