isolate_assets 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc92b30bb9f88b0d8f12eb3ed349f6a6f1f9decbe87a675b7200e70c8c9bd611
-  data.tar.gz: 5aa6ea46f8f8b348f913b1656a6187c3e0875536edb066929f453d997abf7186
+  metadata.gz: b7a0b5e25e5067341e5e3c33c79159bbe1b9fe946efd2683a9c7a1dad13f8d9a
+  data.tar.gz: 9374de1fe6e919a09f742e8d0b483720f9f115e05423487ef88abd3680e1a02c
 SHA512:
-  metadata.gz: 3bb014e542b5067a9b5543f0ae6c6a1c14e8578b1b6f8dbe2d717c304f4798ff11e7293baab555bcdcddba0162067ee172b6ccd6ddf5b92d25dfeb0bc18c2c94
-  data.tar.gz: 96bedf91563d0e5cbea9ac08075e3b5611bdd61a8275fa366058420a7dacbeed2c04845f7c7cce7b424453a2e0638ba0879f403f168cdce2309d38ba67228e59
+  metadata.gz: 98df37ce2970ad2849dced942d34ba434f8e22f4a0590be3fb3b9e693fd557638793f4d88d201b963b2d976d2cefbe7c96c712b67f307c848d7fb89e0c92f325
+  data.tar.gz: '08b88c5fd5862e0ac159c714fef265168554a1d25fbafa60f1aef12cf6e28c34f9b13bd67e74a38f71bdc01458f960a64f904f5a4da802e57b0e1390c946f563'

data/README.md

@@ -154,6 +154,27 @@ This exclusion relies on filtering `config.assets.paths` after engines register
 isolate_assets assets_subdir: "isolated_assets"  # uses app/isolated_assets/
 ```
 
+## Non-isolated engines
+
+`isolate_assets` assumes `isolate_namespace` and a mounted route set. For an engine that isn't isolated — one that draws its routes directly into the application router — use `IsolateAssets.register` instead, then draw the asset route yourself with whatever path and name you want:
+
+```ruby
+# lib/my_engine.rb
+module MyEngine
+  class Engine < ::Rails::Engine; end
+  Assets = IsolateAssets.register(namespace: self, engine: Engine, route_name: :my_engine_asset)
+end
+```
+
+```ruby
+# config/routes.rb (drawn into the application router)
+Rails.application.routes.draw do
+  MyEngine::Assets.draw(self, "/my_engine/assets")
+end
+```
+
+This gives you the same namespaced helpers as the isolated path — `MyEngine.stylesheet_link_tag "app"`, `MyEngine.javascript_include_tag "app"`, etc. — fingerprinted against your chosen route.
+
 ## Requirements
 
 - Ruby 3.2+

data/lib/isolate_assets/assets.rb

@@ -2,7 +2,8 @@
 
 module IsolateAssets
   class Assets
-    attr_reader :engine, :assets_subdir
+    attr_reader :engine, :assets_subdir, :route_name
+    attr_accessor :controller
 
     ASSET_DIRECTORIES = {
       "js" => "javascripts",
@@ -54,12 +55,20 @@ module IsolateAssets
       "ogv" => "video/ogg"
     }.freeze
 
-    def initialize(engine:, assets_subdir: "assets")
+    def initialize(engine:, assets_subdir: "assets", route_name: :isolated_asset, url_helpers: nil)
       @engine = engine
       @assets_subdir = assets_subdir
+      @route_name = route_name
+      @url_helpers = url_helpers || -> { engine.routes.url_helpers }
       @fingerprints = {}
     end
 
+    # Draws the catch-all asset route into the given router (the application
+    # router for non-isolated engines, the engine's own for isolated ones).
+    def draw(mapper, path)
+      mapper.get "#{path}/*file", to: controller.action(:show), as: route_name
+    end
+
     def asset_path(source, type)
       directory = ASSET_DIRECTORIES[type.to_s]
       return nil unless directory
@@ -70,7 +79,11 @@ module IsolateAssets
 
     def asset_url(source, type)
       fingerprint_value = fingerprint(source, type)
-      engine.routes.url_helpers.isolated_asset_path("#{source}.#{normalize_type(type)}", v: fingerprint_value)
+      @url_helpers.call.public_send(
+        "#{route_name}_path",
+        "#{source}.#{normalize_type(type)}",
+        v: fingerprint_value,
+      )
     end
 
     def fingerprint(source, type)

data/lib/isolate_assets/engine_extension.rb

@@ -2,11 +2,6 @@
 
 module IsolateAssets
   module EngineExtension
-    HELPER_METHODS = %i[
-      stylesheet_link_tag javascript_include_tag javascript_importmap_tags
-      asset_path image_path image_tag font_path audio_path audio_tag video_path video_tag
-    ].freeze
-
     def isolate_assets(assets_subdir: "assets")
       engine_class = self
 
@@ -36,35 +31,10 @@ module IsolateAssets
 
       initializer "#{engine_name}.isolate_assets", before: :set_routes_reloader do
         assets = IsolateAssets::Assets.new(engine: engine_class, assets_subdir: assets_subdir)
-
-        # Subclass the controller so that multiple engines using this gem get their own controller
-        controller_class = Class.new(IsolateAssets::Controller)
-        controller_class.isolated_assets = assets
-
-        # Create helper module for inclusion in engine's ApplicationHelper
-        helper_module = Module.new do
-          define_method(:isolated_assets) { assets }
-          include IsolateAssets::Helper
-        end
+        controller_class = IsolateAssets.build_controller(assets)
 
         if engine_class.respond_to?(:railtie_namespace) && engine_class.railtie_namespace
-          namespace = engine_class.railtie_namespace
-
-          # Expose isolated_assets and helper module
-          namespace.singleton_class.define_method(:isolated_assets) { assets }
-          namespace.singleton_class.define_method(:isolated_assets_helper) { helper_module }
-
-          # Define helper methods directly on namespace (e.g., Dummy.stylesheet_link_tag)
-          helper_context = Class.new do
-            include IsolateAssets::Helper
-            define_method(:isolated_assets) { assets }
-          end.new
-
-          HELPER_METHODS.each do |method_name|
-            namespace.singleton_class.define_method(method_name) do |*args, **kwargs, &block|
-              helper_context.send(method_name, *args, **kwargs, &block)
-            end
-          end
+          IsolateAssets.expose_helpers(engine_class.railtie_namespace, assets)
         end
 
         engine_class.routes.prepend do

data/lib/isolate_assets/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IsolateAssets
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/isolate_assets.rb

@@ -9,6 +9,55 @@ module IsolateAssets
   autoload :Controller, "isolate_assets/controller"
   autoload :Helper, "isolate_assets/helper"
   autoload :EngineExtension, "isolate_assets/engine_extension"
+
+  HELPER_METHODS = %i[
+    stylesheet_link_tag javascript_include_tag javascript_importmap_tags
+    asset_path image_path image_tag font_path audio_path audio_tag video_path video_tag
+  ].freeze
+
+  # Wires up an engine that draws its asset route into the application router
+  # rather than mounting an isolated route set. Returns the Assets handle; draw
+  # the route from the engine's routes file with `assets.draw(self, path)`.
+  def self.register(namespace:, engine:, route_name:, assets_subdir: "assets")
+    assets = Assets.new(
+      engine: engine,
+      assets_subdir: assets_subdir,
+      route_name: route_name,
+      url_helpers: -> { Rails.application.routes.url_helpers },
+    )
+    build_controller(assets)
+    expose_helpers(namespace, assets)
+    assets
+  end
+
+  def self.build_controller(assets)
+    controller = Class.new(Controller)
+    controller.isolated_assets = assets
+    assets.controller = controller
+    controller
+  end
+
+  # Defines isolated_assets + the asset tag helpers (stylesheet_link_tag, etc.)
+  # as singleton methods on the given module, e.g. Dummy.stylesheet_link_tag.
+  def self.expose_helpers(namespace, assets)
+    helper_module = Module.new do
+      define_method(:isolated_assets) { assets }
+      include Helper
+    end
+    namespace.singleton_class.define_method(:isolated_assets) { assets }
+    namespace.singleton_class.define_method(:isolated_assets_helper) { helper_module }
+
+    helper_context = Class.new do
+      include Helper
+      define_method(:isolated_assets) { assets }
+    end.new
+    HELPER_METHODS.each do |method_name|
+      namespace.singleton_class.define_method(method_name) do |*args, **kwargs, &block|
+        helper_context.send(method_name, *args, **kwargs, &block)
+      end
+    end
+    helper_module
+  end
 end
 
 # Extend Rails::Engine with isolate_assets

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: isolate_assets
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Micah Geisel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-10 00:00:00.000000000 Z
+date: 2026-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties