Release 0.4.0

Author: dannote

CHANGELOG.md

@@ -1,101 +1,128 @@
 # Changelog
 
-## 0.3.0
+## 0.4.0
 
-### Code Splitting
+### External Globals
 
-Dynamic `import()` expressions are detected during the dependency walk and
-split into separate async chunks. Shared modules between the entry chunk and
-async chunks are extracted into a common chunk to avoid duplication.
+External imports now generate proper global variable access in the IIFE output
+instead of being silently stripped. Supports both auto-derived and explicit names:
 
-```typescript
-const admin = await import('./admin') // → app-admin-c3d4e5f6.js
+```elixir
+config :volt, external: ["vue"]
+# import { ref } from 'vue'  →  const { ref } = Vue;
+
+config :volt, external: %{"vue" => "MyVue"}
+# import { ref } from 'vue'  →  const { ref } = MyVue;
 ```
 
-### External Modules
+### CSS `@import` Inlining
 
-New `:external` option excludes specifiers from the bundle. Essential for
-Phoenix apps where `phoenix`, `phoenix_html`, and `phoenix_live_view` are
-provided by the framework:
+CSS files with `@import` rules are bundled via LightningCSS's Bundler.
+Imports are resolved recursively from disk with proper `@media`/`@supports`/`@layer` wrapping
+and `url()` rebasing.
 
-```elixir
-config :volt, external: ~w(phoenix phoenix_html phoenix_live_view)
+### HTML Entry Points
+
+Entry files can now be HTML — `<script src="...">` tags are extracted
+via Floki and used as JS entry points:
+
+```bash
+mix volt.build --entry index.html
 ```
 
-### Centralized Configuration
+### `import.meta.glob()`
 
-All config now lives under `config :volt` in your standard `config/*.exs` files,
-following the same pattern as `phoenix`, `esbuild`, and `tailwind` hex packages:
+Glob patterns are expanded at build time via OXC AST:
 
-```elixir
-config :volt,
-  entry: "assets/js/app.ts",
-  target: :es2020,
-  external: ~w(phoenix phoenix_html phoenix_live_view),
-  aliases: %{"@" => "assets/src"},
-  tailwind: [css: "assets/css/app.css", sources: [...]]
+```typescript
+const pages = import.meta.glob('./pages/*.ts')
+// → { "./pages/home.ts": () => import("./pages/home.ts"), ... }
+
+const eager = import.meta.glob('./pages/*.ts', { eager: true })
+// → static imports with namespace bindings
 ```
 
-Mix tasks and the DevServer plug read from config automatically.
-CLI flags override for one-off use.
+### Module Preload
 
-### Plugin System
+New `Volt.Preload.tags/2` generates `<link rel="modulepreload">` tags
+from the build manifest for production chunk preloading.
 
-New `Volt.Plugin` behaviour with four optional hooks:
-- `resolve/2` — remap import specifiers
-- `load/1` — provide virtual module content
-- `transform/2` — modify compiled output
-- `render_chunk/2` — modify final output chunks
+### Build Size Reporting
 
-### CSS Modules
+Build output now shows gzip sizes:
 
-`.module.css` files are scoped using LightningCSS (via Vize 0.7.0).
-Class names, IDs, keyframes, and custom identifiers are properly scoped
-through a real CSS parser — no regex.
+```
+app.js  128.4 KB (gzip: 38.2 KB)
+```
 
-### Static Asset Handling
+### Bug Fixes
+
+- **HMR**: Watcher cache lookup used mtime 0, so granular Vue SFC
+  change detection (style-only updates) never worked. Fixed.
+- **Vendor URLs**: Scoped packages (`@vue/shared`) had lossy URL encoding
+  that broke round-trips. Now uses reversible encoding.
+- **CSS errors**: Pipeline `compile_css` had no error clause and would
+  crash on invalid CSS instead of returning an error.
+- **`.env` parser**: Replaced hand-rolled parser with Dotenvy for correct
+  handling of multiline values, variable expansion, and escaping.
+- **IIFE injection**: External globals preamble injection now uses OXC AST
+  to find the function body offset instead of fragile string splitting.
+- **Chunk URLs**: Dynamic import rewriting matches by path suffix instead of
+  basename to avoid collisions between same-named files in different directories.
+
+### Internal Improvements
+
+- Tailwind GenServer lazily initializes QuickBEAM runtime on first call
+  instead of on application start
+- Deduplicated `content_hash`, `file_mtime`, `derive_global_name`,
+  `extract_vue_imports` across modules
+- Vendor cache dir respects `MIX_BUILD_PATH`
+- Tailwind bundle path uses `Application.app_dir` instead of compile-time
+  `:code.priv_dir`
+- HTML parsing uses Floki instead of regex
+- Dependencies: oxc ~> 0.5.2, vize ~> 0.8.0, floki ~> 0.38, dotenvy ~> 1.1
 
-Images, fonts, SVGs, and other non-code files are handled automatically.
-Small files (< 4KB) are inlined as base64 data URIs. Larger files are
-served directly in dev and copied with content-hashed filenames in prod.
+## 0.3.0
 
-### JSON Imports
+### Code Splitting
 
-`import data from './data.json'` compiles to `export default {...}`.
+Dynamic `import()` expressions are detected during the dependency walk and
+split into separate async chunks. Shared modules between the entry chunk and
+async chunks are extracted into a common chunk to avoid duplication.
 
-### Environment Variables
+### External Modules
 
-`.env` files are loaded and variables prefixed with `VOLT_` are available
-as `import.meta.env.VOLT_*` in source code. Built-in `MODE`, `DEV`, and
-`PROD` variables are always available.
+New `:external` option excludes specifiers from the bundle.
+
+### Centralized Configuration
 
-### Import Aliases
+All config now lives under `config :volt` in your standard `config/*.exs` files:
 
 ```elixir
-config :volt, aliases: %{"@" => "assets/src"}
+config :volt,
+  entry: "assets/js/app.ts",
+  target: :es2020,
+  external: ~w(phoenix phoenix_html phoenix_live_view),
+  aliases: %{"@" => "assets/src"},
+  tailwind: [css: "assets/css/app.css", sources: [...]]
 ```
 
-`import { Button } from '@/components/Button'` resolves to the configured path.
+### Plugin System
 
-### Multiple Entry Points
+`Volt.Plugin` behaviour with resolve, load, transform, render_chunk hooks.
 
-`--entry` flag is now repeatable for multi-page apps. Each entry produces
-its own bundle and manifest entries.
+### CSS Modules
 
-### Builder Refactor
+`.module.css` scoped via LightningCSS. No regex.
 
-`Volt.Builder` split into focused submodules:
-- `Volt.Builder.Resolver` — specifier resolution chain
-- `Volt.Builder.Collector` — dependency graph walk with import type detection
-- `Volt.Builder.Output` — chunk bundling, file writing, manifest
-- `Volt.ChunkGraph` — chunk assignment from module dependency map
+### Static Assets, JSON Imports, Env Variables, Import Aliases
 
-### Other Changes
+See README for full details.
+
+### Builder Refactor
 
-- Config values use atoms (`:es2020`, `:production`) instead of strings
-- DevServer serves static assets with correct MIME types
-- `.json` recognized as compilable extension in DevServer and Builder
-- Vize upgraded to 0.7.0 for CSS Modules support
+Split into `Volt.Builder.Resolver`, `Volt.Builder.Collector`,
+`Volt.Builder.Output`, and `Volt.ChunkGraph`.
 
 ## 0.2.0
 

README.md

@@ -26,7 +26,7 @@ Built on Rust NIFs: [OXC](https://hex.pm/packages/oxc) for JS/TS, [Vize](https:/
 
 ```elixir
 def deps do
-  [{:volt, "~> 0.3.0"}]
+  [{:volt, "~> 0.4.0"}]
 end
 ```
 

examples/demo/config/config.exs

@@ -35,6 +35,7 @@ config :volt,
   outdir: "priv/static/assets",
   target: :es2020,
   resolve_dirs: ["deps"],
+  # external: ~w(phoenix phoenix_html phoenix_live_view),
   tailwind: [
     css: "assets/css/app.css",
     sources: [

examples/demo/mix.lock

@@ -3,10 +3,12 @@
   "castore": {:hex, :castore, "1.0.17", "4f9770d2d45fbd91dcf6bd404cf64e7e58fed04fadda0923dc32acca0badffa2", [:mix], [], "hexpm", "12d24b9d80b910dd3953e165636d68f147a31db945d2dcb9365e441f8b5351e5"},
   "cc_precompiler": {:hex, :cc_precompiler, "0.1.11", "8c844d0b9fb98a3edea067f94f616b3f6b29b959b6b3bf25fee94ffe34364768", [:mix], [{:elixir_make, "~> 0.7", [hex: :elixir_make, repo: "hexpm", optional: false]}], "hexpm", "3427232caf0835f94680e5bcf082408a70b48ad68a5f5c0b02a3bea9f3a075b9"},
   "dns_cluster": {:hex, :dns_cluster, "0.2.0", "aa8eb46e3bd0326bd67b84790c561733b25c5ba2fe3c7e36f28e88f384ebcb33", [:mix], [], "hexpm", "ba6f1893411c69c01b9e8e8f772062535a4cf70f3f35bcc964a324078d8c8240"},
+  "dotenvy": {:hex, :dotenvy, "1.1.1", "00e318f3c51de9fafc4b48598447e386f19204dc18ca69886905bb8f8b08b667", [:mix], [], "hexpm", "c8269471b5701e9e56dc86509c1199ded2b33dce088c3471afcfef7839766d8e"},
   "elixir_make": {:hex, :elixir_make, "0.9.0", "6484b3cd8c0cee58f09f05ecaf1a140a8c97670671a6a0e7ab4dc326c3109726", [:mix], [], "hexpm", "db23d4fd8b757462ad02f8aa73431a426fe6671c80b200d9710caf3d1dd0ffdb"},
   "file_system": {:hex, :file_system, "1.1.1", "31864f4685b0148f25bd3fbef2b1228457c0c89024ad67f7a81a3ffbc0bbad3a", [:mix], [], "hexpm", "7a15ff97dfe526aeefb090a7a9d3d03aa907e100e262a0f8f7746b78f8f87a5d"},
   "finch": {:hex, :finch, "0.21.0", "b1c3b2d48af02d0c66d2a9ebfb5622be5c5ecd62937cf79a88a7f98d48a8290c", [:mix], [{:mime, "~> 1.0 or ~> 2.0", [hex: :mime, repo: "hexpm", optional: false]}, {:mint, "~> 1.6.2 or ~> 1.7", [hex: :mint, repo: "hexpm", optional: false]}, {:nimble_options, "~> 0.4 or ~> 1.0", [hex: :nimble_options, repo: "hexpm", optional: false]}, {:nimble_pool, "~> 1.1", [hex: :nimble_pool, repo: "hexpm", optional: false]}, {:telemetry, "~> 0.4 or ~> 1.0", [hex: :telemetry, repo: "hexpm", optional: false]}], "hexpm", "87dc6e169794cb2570f75841a19da99cfde834249568f2a5b121b809588a4377"},
   "fine": {:hex, :fine, "0.1.4", "b19a89c1476c7c57afb5f9314aed5960b5bc95d5277de4cb5ee8e1d1616ce379", [:mix], [], "hexpm", "be3324cc454a42d80951cf6023b9954e9ff27c6daa255483b3e8d608670303f5"},
+  "floki": {:hex, :floki, "0.38.0", "62b642386fa3f2f90713f6e231da0fa3256e41ef1089f83b6ceac7a3fd3abf33", [:mix], [], "hexpm", "a5943ee91e93fb2d635b612caf5508e36d37548e84928463ef9dd986f0d1abd9"},
   "heroicons": {:git, "https://github.com/tailwindlabs/heroicons.git", "0435d4ca364a608cc75e2f8683d374e55abbae26", [tag: "v2.2.0", sparse: "optimized", depth: 1]},
   "hex_solver": {:hex, :hex_solver, "0.2.3", "0d2ee20fbceb251d573f03ef34852e325529c2874ab66d1b576384021318996c", [:mix], [], "hexpm", "9daeae2ea6b8ad3dc7f51a10484f6bc1d0f705c31063383830a7167ab93b887b"},
   "hpax": {:hex, :hpax, "1.0.3", "ed67ef51ad4df91e75cc6a1494f851850c0bd98ebc0be6e81b026e765ee535aa", [:mix], [], "hexpm", "8eab6e1cfa8d5918c2ce4ba43588e894af35dbd8e91e6e55c817bca5847df34a"},

mix.exs

@@ -1,7 +1,7 @@
 defmodule Volt.MixProject do
   use Mix.Project
 
-  @version "0.3.0"
+  @version "0.4.0"
   @source_url "https://github.com/elixir-volt/volt"
 
   def project do