rails_vite 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e21a7726c621ab685293e27628370999aa8f4eac432f7bba906385f61e07e9d7
-  data.tar.gz: 1b960c132edf8437be44cf32237c2b13e87fdf0611c009a90a3c5807e6f117d9
+  metadata.gz: f9257421d49c1d9cc9dc84fb86429215d7bf94af8a0352a9731d209fb38b6565
+  data.tar.gz: a7830e222230ad5780ff0bb02740b82136d3dfdc1e6e820b75b15ab831b97e31
 SHA512:
-  metadata.gz: 4e4c557a47e858aece8cfaa5d80e1f39b1858327107ff92142b44d329a37713bbba32a84075eb821a5ef89c25150be8a374fbdec756bfef24dfbb5d88266878c
-  data.tar.gz: 6fbadd4536700b156f151250abb377665d099ae0ace3c2b97f9e60bcc6a2df510efb6f3d7c39c53d85030e5842807d6aa9d4b21b87eb86e2716c24b324618417
+  metadata.gz: 899b0835c623650138a1d09924f141a638d408f4e067e2321637f5861b40f84afc1979e9ed0bccea3bd4b105db6d57f6646a6ab24405df1f4f36207ad0de05e6
+  data.tar.gz: 96ddd4ab25a3de8d247ca297a04844c022ad865666139e5150c695e2b304e55d5337216eeed5a8250f32f1393a818484a1cd746db588ae92447ef74d821e3c25

data/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning].
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-03-08
+
+### Added
+
+- Support custom HTML attributes in `vite_tags` (e.g., `data-turbo-track`, `media`) ([@skryukov])
+- Add `vite_javascript_tag`, `vite_stylesheet_tag`, and `vite_typescript_tag` compat helpers for easier migration from vite_rails ([@skryukov])
+- Auto-discover entrypoints from `sourceDir/entrypoints/` directory ([@skryukov])
+- Support extensionless entry names in `vite_tags` (e.g., `vite_tags("application")`) ([@skryukov])
+- Subresource Integrity (SRI) support — automatically adds `integrity` and `crossorigin` attributes when `vite-plugin-manifest-sri` is used ([@skryukov])
+
+### Fixed
+
+- `refresh: false` option now correctly disables file watching ([@skryukov])
+
 ## [0.1.0] - 2026-03-07
 
 ### Added
@@ -15,7 +29,8 @@ and this project adheres to [Semantic Versioning].
 
 [@skryukov]: https://github.com/skryukov
 
-[Unreleased]: https://github.com/skryukov/rails_vite/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/skryukov/rails_vite/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/skryukov/rails_vite/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/skryukov/rails_vite/commits/v0.1.0
 
 [Keep a Changelog]: https://keepachangelog.com/en/1.0.0/

data/README.md

@@ -1,7 +1,29 @@
 # RailsVite
 
+[![Gem Version](https://badge.fury.io/rb/rails_vite.svg)](https://rubygems.org/gems/rails_vite)
+
 Vite integration for Rails, inspired by [Laravel's Vite plugin](https://laravel.com/docs/12.x/vite). No proxy, no config duplication, no magic.
 
+## Table of Contents
+
+- [How It Works](#how-it-works)
+- [Quick Start](#quick-start)
+- [Usage](#usage)
+- [Vite Config](#vite-config)
+- [Adding Frameworks](#adding-frameworks)
+- [SSR](#ssr)
+- [Auto Build](#auto-build)
+- [Testing the Build](#testing-the-build)
+- [Custom Paths](#custom-paths)
+- [Rake Tasks](#rake-tasks)
+- [Migrating from vite_rails](#migrating-from-vite_rails)
+- [Contributing](#contributing)
+- [License](#license)
+
+<a href="https://evilmartians.com/?utm_source=rails_vite&utm_campaign=project_page">
+<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Built by Evil Martians" width="236" height="54">
+</a>
+
 ## How It Works
 
 **Development:** The Vite plugin writes `tmp/rails-vite.json` with the dev server URL. The Rails helper reads it and emits `<script>` tags pointing directly at Vite. The browser talks to Vite — Puma never touches your assets.
@@ -62,10 +84,20 @@ Short names are automatically prefixed with `sourceDir` (default: `app/javascrip
 
 | Helper | Purpose |
 |--------|---------|
-| `vite_tags(*entries, nonce: nil)` | Emits script, stylesheet, and modulepreload tags |
+| `vite_tags(*entries, **options)` | Emits script, stylesheet, and modulepreload tags |
+| `vite_javascript_tag(*entries, **options)` | Same as `vite_tags`, appends `.js` to extensionless names |
+| `vite_stylesheet_tag(*entries, **options)` | Same as `vite_tags`, appends `.css` to extensionless names |
+| `vite_typescript_tag(*entries, **options)` | Same as `vite_tags`, appends `.ts` to extensionless names |
 | `vite_asset_path(name)` | Returns the fingerprinted path from the manifest |
 | `vite_image_tag(name, **options)` | Image tag with manifest-resolved src |
 
+All tag helpers accept arbitrary HTML attributes:
+
+```erb
+<%= vite_tags "application.js", "application.css",
+    "data-turbo-track": "reload", nonce: content_security_policy_nonce %>
+```
+
 ### CSS Entry Points
 
 CSS files are detected by extension and emit `<link rel="stylesheet">`:
@@ -80,6 +112,29 @@ CSS files are detected by extension and emit `<link rel="stylesheet">`:
 <%= vite_tags "application.js", nonce: content_security_policy_nonce %>
 ```
 
+### Subresource Integrity (SRI)
+
+[SRI](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) lets browsers verify that fetched assets haven't been tampered with by checking cryptographic hashes. Install the [`vite-plugin-manifest-sri`](https://github.com/nicolo-ribaudo/vite-plugin-manifest-sri) plugin:
+
+```bash
+npm install -D vite-plugin-manifest-sri
+```
+
+```typescript
+import { defineConfig } from 'vite';
+import rails from 'rails-vite-plugin';
+import manifestSRI from 'vite-plugin-manifest-sri';
+
+export default defineConfig({
+  plugins: [
+    rails(),
+    manifestSRI(),
+  ],
+});
+```
+
+That's it — `integrity` and `crossorigin="anonymous"` attributes are automatically added to all script, stylesheet, and modulepreload tags when the manifest includes integrity hashes.
+
 ### Asset Discovery (Images, Fonts)
 
 Use `import.meta.glob` in your entry point to include assets in the Vite manifest:
@@ -114,7 +169,7 @@ export default defineConfig({
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `input` | auto-detected | Entry point(s). Auto-detects `application.{js,ts,jsx,tsx}` in `sourceDir` |
+| `input` | auto-detected | Entry point(s). If `sourceDir/entrypoints/` exists, all files in it are used. Otherwise, detects `application.{js,ts,jsx,tsx}` in `sourceDir` |
 | `sourceDir` | `'app/javascript'` | Source directory. Short names are prefixed with this. Also sets the `@` import alias |
 | `ssr` | — | SSR entry point |
 | `ssrOutputDirectory` | `'ssr'` | SSR output directory |
@@ -262,6 +317,50 @@ Defaults match the plugin defaults — no config needed if you follow convention
 `vite:build` hooks into `assets:precompile` and `test:prepare` automatically. Skip with `SKIP_VITE_BUILD=1`.
 
 
+## Migrating from vite_rails
+
+### 1. Swap dependencies
+
+```ruby
+# Gemfile
+- gem "vite_rails"
++ gem "rails_vite"
+```
+
+```json
+// package.json — replace vite-plugin-ruby with rails-vite-plugin
+- "vite-plugin-ruby": "^5.1.1"
++ "rails-vite-plugin": "^0.1.0"
+```
+
+### 2. Replace `vite.config.ts`
+
+```typescript
+import { defineConfig } from 'vite';
+import rails from 'rails-vite-plugin';
+
+export default defineConfig({
+  plugins: [
+    rails({
+      sourceDir: 'app/frontend',
+    }),
+  ],
+});
+```
+
+If you have an `entrypoints/` directory inside `sourceDir`, all files in it are auto-discovered — no need to list them. Otherwise, set `input` explicitly.
+
+### 3. Delete files
+
+- `config/vite.json` — settings now live in `vite.config.ts`
+- `bin/vite` — no longer needed, `Procfile.dev` runs `npx vite` directly
+
+### 4. Update layouts
+
+Remove `vite_client_tag` and `vite_react_refresh_tag` — both are automatic now.
+
+The `vite_javascript_tag`, `vite_stylesheet_tag`, and `vite_typescript_tag` helpers work as drop-in replacements:
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/skryukov/rails_vite.

data/lib/rails_vite/manifest.rb

@@ -6,13 +6,18 @@ module RailsVite
       @path = path
     end
 
+    # Vite's default resolve.extensions order, plus CSS extensions
+    RESOLVE_EXTENSIONS = %w[.mjs .js .mts .ts .jsx .tsx .json .css .scss .sass .less .styl .pcss].freeze
+
     def lookup(name)
       manifest = data
-      entry = manifest[name] || raise(MissingEntryError.new(name, @path))
+      entry = manifest[name] || resolve_with_extension(name, manifest) ||
+        raise(MissingEntryError.new(name, @path))
 
       {
         file: entry["file"],
-        css: entry.fetch("css", []),
+        integrity: entry["integrity"],
+        css: resolve_css(entry, manifest),
         imports: resolve_imports(entry, Set.new, manifest)
       }
     end
@@ -43,6 +48,23 @@ module RailsVite
       raise MissingManifestError.new(@path)
     end
 
+    def resolve_with_extension(name, manifest)
+      return if File.extname(name).present?
+
+      RESOLVE_EXTENSIONS.each do |ext|
+        entry = manifest["#{name}#{ext}"]
+        return entry if entry
+      end
+      nil
+    end
+
+    def resolve_css(entry, manifest)
+      entry.fetch("css", []).map do |css_file|
+        integrity = manifest.values.find { |e| e["file"] == css_file }&.dig("integrity")
+        {file: css_file, integrity: integrity}
+      end
+    end
+
     def resolve_imports(entry, seen, manifest)
       entry.fetch("imports", []).flat_map do |import_key|
         next [] if seen.include?(import_key)
@@ -51,7 +73,8 @@ module RailsVite
         imported = manifest[import_key]
         next [] unless imported
 
-        [imported["file"]] + resolve_imports(imported, seen, manifest)
+        [{file: imported["file"], integrity: imported["integrity"]}] +
+          resolve_imports(imported, seen, manifest)
       end
     end
   end

data/lib/rails_vite/tag_helper.rb

@@ -7,11 +7,24 @@ module RailsVite
       resolved = entries.map { |e| resolve_vite_entry(e, config.source_dir) }
 
       if config.dev_server_running?
-        vite_dev_tags(resolved, config.dev_server_url, nonce: nonce)
+        vite_dev_tags(resolved, config.dev_server_url, nonce: nonce, **options)
       else
-        vite_prod_tags(resolved, nonce: nonce)
+        vite_prod_tags(resolved, nonce: nonce, **options)
       end
     end
+    alias_method :vite_tag, :vite_tags
+
+    def vite_javascript_tag(*entries, **options)
+      vite_tags(*entries.map { |e| with_default_ext(e, ".js") }, **options)
+    end
+
+    def vite_stylesheet_tag(*entries, **options)
+      vite_tags(*entries.map { |e| with_default_ext(e, ".css") }, **options)
+    end
+
+    def vite_typescript_tag(*entries, **options)
+      vite_tags(*entries.map { |e| with_default_ext(e, ".ts") }, **options)
+    end
 
     def vite_asset_path(name)
       vite_asset_url(RailsVite.manifest.path_for(name))
@@ -23,7 +36,7 @@ module RailsVite
 
     private
 
-    def vite_dev_tags(entries, dev_url, nonce: nil)
+    def vite_dev_tags(entries, dev_url, nonce: nil, **options)
       tags = []
 
       unless @_vite_client_emitted
@@ -42,43 +55,54 @@ module RailsVite
       end
 
       entries.each do |entry|
-        tags << build_asset_tag(entry, "#{dev_url}/#{entry}", nonce: nonce)
+        tags << build_asset_tag(entry, "#{dev_url}/#{entry}", nonce: nonce, **options)
       end
 
       safe_join(tags, "\n")
     end
 
-    def vite_prod_tags(entries, nonce: nil)
+    def vite_prod_tags(entries, nonce: nil, **options)
       tags = []
       preloaded = Set.new
 
       entries.each do |entry|
         result = RailsVite.manifest.lookup(entry)
 
-        Array(result[:imports]).each do |import_file|
-          next if preloaded.include?(import_file)
-          preloaded.add(import_file)
-          tags << tag.link(rel: "modulepreload", href: vite_asset_url(import_file), nonce: nonce)
+        Array(result[:imports]).each do |import_entry|
+          next if preloaded.include?(import_entry[:file])
+          preloaded.add(import_entry[:file])
+          tags << tag.link(rel: "modulepreload", href: vite_asset_url(import_entry[:file]),
+            nonce: nonce, **sri_attrs(import_entry[:integrity]))
         end
 
-        tags << build_asset_tag(entry, vite_asset_url(result[:file]), nonce: nonce)
+        tags << build_asset_tag(entry, vite_asset_url(result[:file]),
+          nonce: nonce, integrity: result[:integrity], **options)
 
-        Array(result[:css]).each do |css_file|
-          tags << tag.link(rel: "stylesheet", href: vite_asset_url(css_file), nonce: nonce)
+        Array(result[:css]).each do |css_entry|
+          tags << tag.link(rel: "stylesheet", href: vite_asset_url(css_entry[:file]),
+            nonce: nonce, **sri_attrs(css_entry[:integrity]), **options)
         end
       end
 
       safe_join(tags, "\n")
     end
 
-    def build_asset_tag(entry, url, nonce: nil)
+    def build_asset_tag(entry, url, nonce: nil, integrity: nil, **options)
       if css_entry?(entry)
-        tag.link(rel: "stylesheet", href: url, nonce: nonce)
+        tag.link(rel: "stylesheet", href: url, nonce: nonce, **sri_attrs(integrity), **options)
       else
-        tag.script(src: url, type: "module", nonce: nonce)
+        tag.script(src: url, type: "module", nonce: nonce, **sri_attrs(integrity), **options)
       end
     end
 
+    def sri_attrs(integrity)
+      integrity ? {integrity: integrity, crossorigin: "anonymous"} : {}
+    end
+
+    def with_default_ext(name, ext)
+      File.extname(name).empty? ? "#{name}#{ext}" : name
+    end
+
     def resolve_vite_entry(entry, source_dir)
       entry.start_with?("#{source_dir}/", "/") ? entry : "#{source_dir}/#{entry}"
     end

data/lib/rails_vite/version.rb

@@ -1,3 +1,3 @@
 module RailsVite
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_vite
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Svyatoslav Kryukov