@normed/bundle 2.0.1 → 2.0.4

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# 2.0.4
+
+* MINOR: Fixes builds to actually use the normal compiler and not tsc
+* MINOR: declarations now work for typescript
+* MINOR: metafiles can be output with --analyse
+
+# 2.0.3
+
+* MINOR: Adds color
+* MINOR: Bumps dependencies
+* MINOR: Uses bundle's own log function for logging in cli rather than console.log/error
+* MINOR: Fixes build to support ES202 and less types
+* MINOR: Correctly handles escaping Windows paths during substitution
+* MINOR: Alters build logs to have relative paths only

package/README.md

@@ -0,0 +1,35 @@
+# Premise
+
+A used-in-production proof of concept bundler, `@normed/bundle` bundles with output directory structure as *the* first class citizen. Given files in a source directory (defaults to `src`) it transpiles and bundles the entrypoints into the destination directory (defaults to `bundles`). The twist is that any file containing the pre-prefix `static` is automatically an entrypoint, and aside from stripping the pre-prefix and transforming the prefix (ie. `ts` -> `js`) the relative structure remains the same.
+
+## Examples
+
+```
+in:                                 out:
+  src/                                bundles/
+  ├─ api.ts                           |
+  ├─ logger.ts                        |
+  ├─ index.static.ts                  ├─ index.js
+  ├─ public/                          ├─ public/
+     ├─ base.style.less                  |
+     ├─ favicon.static.ico               ├─ favicon.ico
+     ├─ index.static.less                ├─ index.css
+     ├─ index.static.pug                 ├─ index.html
+     ├─ index.static.ts                  ├─ index.js
+```
+
+# Things to note
+
+The following global javascript variables are available in most environments:
+* `__filename` and `__dirname` - refers to the executing bundle filename/dirname
+The following additional variables provided by `@normed/bundle`, and do not exist by default if not built by `@normed/bundle`:
+* `__source_filename` and `__source_dirname` - refer to the original source files absolute filename/dirname
+* `__source_relative_filename` and `__source_relative_dirname` - refer to the original source files filename/direnation relative to the source directory
+
+The current version of `@normed/bundle` is built on top of es-build for speed.
+
+# Development
+
+## build pipeline
+
+`@normed/bundle` is bootstrapped by being built from typescript to javascript first (using `tsc`, output to `dist`), then using the javascript output to build the original source (output to `bundles-a`), then using that output to build the original source again (output to `bundles`), and finally the last two outputs are compared to ensure they are the same.

package/bundles/bin/cli.d.ts

@@ -0,0 +1 @@
+export {};