proscenium 0.21.6-arm64-darwin → 0.22.0-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bafa3c4ef5b5b97a3a1049ee46f1a1c725dc2191158dd84869b189ee64409c03
-  data.tar.gz: 91625ccd60bbc983dd99dd2368ee3422e0e9b12593e5cb2b207d8f4e6b4a2591
+  metadata.gz: 223869aa06c452bb332f16d9be4254ac0a7e542da2666879164c3f5fd93344e4
+  data.tar.gz: bd6e10dc0a32400009a74628a6ec2a5bee1cdbed99839e9ca1a1978a7e60243a
 SHA512:
-  metadata.gz: e58c3404b1687bcdef9e59b0f8f5d291db9cb1bdffd805c2c86c54259e8eac4b4615266a79863e238e778d83a1166cc3b79a739e418c8b4e48468b88d51d97ff
-  data.tar.gz: 2172db0bc1b008e011baa6b16eeb50b4e742ab532572d8f0c2d684b698a927b88ae2c310264ef6d9ed4560b9652a1a606e4717e175b86fb7fbc269312f62e10c
+  metadata.gz: 541fe7b47d257d2ba454c50a2ae587d971c610b583a8e7468862a25279029ea71cf1d722918b75131b640859a534a4dfc5af83db71c90da75380e97b7839d7f8
+  data.tar.gz: 9cae265e01be8700e82a5ff56b175b1a123d7f7304014211e423d31936bcad196a76947ae4497c0d49db5f494b356cbdc8b9efe39a9ce35ca92dfbb58046c3d6

data/README.md

@@ -18,7 +18,6 @@
 - Deep integration with Rails.
 - Automatically side-load JS and CSS for your layouts, views, and partials.
 - Import from NPM, URL's, and locally.
-- Server-side import map support.
 - CSS Modules & mixins.
 - Source maps.
 
@@ -30,7 +29,6 @@
 - [Side Loading](#side-loading)
 - [Importing](#importing-assets)
   - [Local Imports](#local-imports)
-- [Import Maps](#import-maps)
 - [Source Maps](#source-maps)
 - [SVG](#svg)
 - [Environment Variables](#environment-variables)
@@ -48,9 +46,10 @@
   - [Typescript Caveats](#typescript-caveats)
 - [JSX](#jsx)
 - [JSON](#json)
-- [Cache Busting](#cache-busting)
 - [rjs is back!](#rjs-is-back)
 - [Resolution](#resolution)
+- [Aliases](#aliases)
+- [Pre-compilation](#precompilation)
 - [Thanks](#thanks)
 - [Development](#development)
 
@@ -258,13 +257,11 @@ Sometimes you don't want to bundle an import. For example, you want to ensure th
 import React from "react" with { unbundle: 'true' };
 ```
 
-You can also unbundle entries in your [import map](#import-maps) using an `unbundle:` prefix, which ensures that all imports of a particular path are always unbundled:
+You can also unbundle entries in [`aliases`](#aliases) using an `unbundle:` prefix, which ensures that all imports of a particular path are always unbundled:
 
-```json
-{
-  "imports": {
-    "react": "unbundle:react"
-  }
+```ruby
+config.proscenium.aliases = {
+  "react": "unbundle:react"
 }
 ```
 
@@ -282,55 +279,6 @@ config.proscenium.bundle = false
 
 This will mean every asset and import will be loaded independently.
 
-## Import Maps
-
-> **[WIP]**
-
-[Import maps](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap) for both JS and CSS is supported out of the box, and works with no regard to the browser being used. This is because the import map is parsed and resolved by Proscenium on the server, instead of by the browser. This is faster, and also allows you to use import maps in browsers that do not support them yet.
-
-If you are not familiar with import maps, think of them as a way to define aliases.
-
-Just create `config/import_map.json` and specify the imports you want to use. For example:
-
-```json
-{
-  "imports": {
-    "react": "https://esm.sh/react@18.2.0",
-    "start": "/lib/start.js",
-    "common": "/lib/common.css",
-    "@radix-ui/colors/": "https://esm.sh/@radix-ui/colors@0.1.8/"
-  }
-}
-```
-
-Using the above import map, we can do...
-
-```js
-import { useCallback } from "react";
-import startHere from "start";
-import styles from "common";
-```
-
-and for CSS...
-
-```css
-@import "common";
-@import "@radix-ui/colors/blue.css";
-```
-
-You can also write your import map in JavaScript instead of JSON. So instead of `config/import_map.json`, create `config/import_map.js`, and define an anonymous function. This function accepts a single `environment` argument.
-
-```js
-(env) => ({
-  imports: {
-    react:
-      env === "development"
-        ? "https://esm.sh/react@18.2.0?dev"
-        : "https://esm.sh/react@18.2.0",
-  },
-});
-```
-
 ## Source Maps
 
 Source maps can make it easier to debug your code. They encode the information necessary to translate from a line/column offset in a generated output file back to a line/column offset in the corresponding original input file. This is useful if your generated code is sufficiently different from your original code (e.g. your original code is TypeScript or you enabled minification). This is also useful if you prefer looking at individual files in your browser's developer tools instead of one big bundled file.
@@ -692,39 +640,59 @@ import { version } from "./package.json";
 console.log(version);
 ```
 
-## Cache Busting
+## rjs is back
 
-By default, all assets are not cached by the browser. But if in production, you populate the `REVISION` env variable, all CSS and JS URL's will be appended with its value as a query string, and the `Cache-Control` response header will be set to `public` and a max-age of 30 days.
+Proscenium brings back RJS! Any path ending in .rjs will be served from your Rails app. This allows you to import server rendered javascript.
 
-For example, if you set `REVISION=v1`, URL's will be appended with `?v1`: `/my/imported/file.js?v1`.
+## Resolution
 
-It is assumed that the `REVISION` env var will be unique between deploys. If it isn't, then assets will continue to be cached as the same version between deploys. I recommend you assign a version number or to use the Git commit hash of the deploy. Just make sure it is unique for each deploy.
+Proscenium will serve files ending with any of these extension: `js,mjs,ts,css,jsx,tsx` from the following directories, and their sub-directories of your Rails application's root: `/app`, `/lib`, `/config`, `/node_modules`, `/vendor`.
 
-You can set the `cache_query_string` config option directly to define any query string you wish:
+So a file at `/app/views/users/index.js` will be served from `https://localhost:3000/app/views/users/index.js`.
 
-```ruby
-Rails.application.config.proscenium.cache_query_string = 'my-cache-busting-version-string'
-```
+You can continue to access any file in the `/public` directory as you normally would. Proscenium will not process files in the `/public` directory.
+
+If requesting a file that exists in a root directory and the public directory, the file in the public directory will be served. For example, if you have a file at `/lib/foo.js` and `/public/lib/foo.js`, and you request `/lib/foo.js`, the file in the public directory (`/public/lib/foo.js`) will be served.
+
+## Aliases
 
-The cache is set with a `max-age` of 30 days. You can customise this with the `cache_max_age` config option:
+You can define import aliases via the `config.proscenium.aliases` config option. This allows you to create shorter or more meaningful import paths.
 
 ```ruby
-Rails.application.config.proscenium.cache_max_age = 12.months.to_i
+config.proscenium.aliases = {
+  "utils": "/lib/utils.js",
+  "components": "/app/components"
+}
 ```
 
-## rjs is back
+You can then import using the alias:
 
-Proscenium brings back RJS! Any path ending in .rjs will be served from your Rails app. This allows you to import server rendered javascript.
+```js
+import utils from "utils";
+import Header from "components/header";
+```
 
-## Resolution
+## Pre-compilation
 
-Proscenium will serve files ending with any of these extension: `js,mjs,ts,css,jsx,tsx` from the following directories, and their sub-directories of your Rails application's root: `/app`, `/lib`, `/config`, `/node_modules`, `/vendor`.
+Proscenium is designed to bundle and minify your frontend code in real time, on demand, with no build step or pre-compilation needed. However, if you want to pre-compile your assets for production deployment, you can do so using the `assets:precompile` Rake task.
 
-So a file at `/app/views/users/index.js` will be served from `https://localhost:3000/app/views/users/index.js`.
+```bash
+rails assets:precompile
+```
 
-You can continue to access any file in the `/public` directory as you normally would. Proscenium will not process files in the `/public` directory.
+Be sure to specify a `Set` of paths which you want to pre-compile via the `config.proscenium.precompile` configuration option. Each path should be a glob pattern that matches the files which are your entry points. Don't include paths that are not entry points. For example:
 
-If requesting a file that exists in a root directory and the public directory, the file in the public directory will be served. For example, if you have a file at `/lib/foo.js` and `/public/lib/foo.js`, and you request `/lib/foo.js`, the file in the public directory (`/public/lib/foo.js`) will be served.
+```ruby
+Rails.configuration.proscenium.precompile = Set[
+  "./app/components/**/*.js",
+  "./app/components/**/*.jsx",
+  "./app/views/**/*.js",
+  "./app/views/**/*.css",
+  "./app/views/**/*.module.css"
+]
+```
+
+This will bundle, code split, tree shake, and compile all your JS, TS, JSX, TSX and CSS files and place them in the `public/assets` directory, ready to be served in production.
 
 ## Thanks
 

data/lib/proscenium/builder.rb

@@ -4,8 +4,6 @@ require 'ffi'
 
 module Proscenium
   class Builder
-    class CompileError < StandardError; end
-
     ENVIRONMENTS = { development: 1, test: 2, production: 3 }.freeze
 
     class Result < FFI::Struct
@@ -14,6 +12,11 @@ module Proscenium
              :content_hash, :string
     end
 
+    class CompileResult < FFI::Struct
+      layout :success, :bool,
+             :messages, :string
+    end
+
     module Request
       extend FFI::Library
 
@@ -23,7 +26,6 @@ module Proscenium
 
       attach_function :build_to_string, [
         :string, # Path or entry point.
-        :string, # cache_query_string.
         :pointer # Config as JSON.
       ], Result.by_value
 
@@ -32,41 +34,51 @@ module Proscenium
         :pointer # Config as JSON.
       ], Result.by_value
 
+      attach_function :compile, [
+        :pointer # Config as JSON.
+      ], CompileResult.by_value
+
       attach_function :reset_config, [], :void
     end
 
-    class BuildError < StandardError
-      attr_reader :error
+    class BuildError < Error
+      attr_reader :error, :path
 
-      def initialize(error)
-        @error = JSON.parse(error, strict: true).deep_transform_keys(&:underscore)
+      def initialize(path, error)
+        @path = path
+        @error = JSON.parse(error, strict: true)
 
-        msg = @error['text']
-        msg << ' - ' << @error['detail'] if @error['detail'].is_a?(String)
-        if (location = @error['location'])
-          msg << " at #{location['file']}:#{location['line']}:#{location['column']}"
+        msg = @error['Text']
+        msg << ' - ' << @error['Detail'] if @error['Detail'].is_a?(String)
+        if (location = @error['Location'])
+          msg << " at #{location['File']}:#{location['Line']}:#{location['Column']}"
         end
 
-        super(msg)
+        super("Failed to build #{path} - #{msg}")
       end
     end
 
-    class ResolveError < StandardError
-      attr_reader :error_msg, :path
+    class ResolveError < Error
+      attr_reader :path
 
-      def initialize(path, error_msg)
-        super("Failed to resolve '#{path}' -- #{error_msg}")
+      def initialize(path, msg)
+        @path = path
+        super("Failed to resolve #{path} - #{msg}")
       end
     end
 
-    def self.build_to_string(path, cache_query_string: '', root: nil)
-      new(root:).build_to_string(path, cache_query_string:)
+    def self.build_to_string(path, root: nil)
+      new(root:).build_to_string(path)
     end
 
     def self.resolve(path, root: nil)
       new(root:).resolve(path)
     end
 
+    def self.compile(root: nil)
+      new(root:).compile
+    end
+
     # Intended for tests only.
     def self.reset_config!
       Request.reset_config
@@ -75,6 +87,7 @@ module Proscenium
     def initialize(root: nil)
       @request_config = FFI::MemoryPointer.from_string({
         RootPath: (root || Rails.root).to_s,
+        OutputDir: "public#{Proscenium.config.output_dir}",
         GemPath: gem_root,
         Environment: ENVIRONMENTS.fetch(Rails.env.to_sym, 2),
         EnvVars: env_vars,
@@ -82,16 +95,17 @@ module Proscenium
         RubyGems: Proscenium::BundledGems.paths,
         Bundle: Proscenium.config.bundle,
         Aliases: Proscenium.config.aliases,
-        QueryString: Proscenium.config.cache_query_string.presence || '',
+        External: Proscenium.config.external,
+        Precompile: Proscenium.config.precompile,
         Debug: Proscenium.config.debug
       }.to_json)
     end
 
-    def build_to_string(path, cache_query_string: '')
+    def build_to_string(path)
       ActiveSupport::Notifications.instrument('build.proscenium', identifier: path) do
-        result = Request.build_to_string(path, cache_query_string, @request_config)
+        result = Request.build_to_string(path, @request_config)
 
-        raise BuildError, result[:response] unless result[:success]
+        raise BuildError.new(path, result[:response]) unless result[:success]
 
         result
       end
@@ -107,6 +121,11 @@ module Proscenium
       end
     end
 
+    def compile
+      result = Request.compile(@request_config)
+      result[:success]
+    end
+
     private
 
     # Build the ENV variables as determined by `Proscenium.config.env_vars` and

data/lib/proscenium/css_module.rb

@@ -7,7 +7,7 @@ module Proscenium::CssModule
   autoload :Transformer
   autoload :Rewriter
 
-  class TransformError < StandardError
+  class TransformError < Proscenium::Error
     def initialize(name, additional_msg = nil)
       msg = "Failed to transform CSS module `#{name}`"
       msg << ' - ' << additional_msg if additional_msg

data/lib/proscenium/ensure_loaded.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Proscenium
-  NotIncludedError = Class.new(StandardError)
+  NotIncludedError = Class.new(Error)
 
   module EnsureLoaded
     def self.included(child)

data/lib/proscenium/ext/proscenium.h

@@ -25,6 +25,10 @@ struct Result {
 	int success;
 	char* response;
 	char* contentHash;
+	};
+struct CompileResult {
+	int success;
+	char* messages;
 };
 
 #line 1 "cgo-generated-wrapper"
@@ -90,7 +94,7 @@ extern void reset_config();
 // - path - The path to build relative to `root`.
 // - config
 //
-extern struct Result build_to_string(char* filePath, char* cacheQueryString, char* configJson);
+extern struct Result build_to_string(char* filePath, char* configJson);
 
 // Resolve the given `path` relative to the `root`.
 //
@@ -99,6 +103,12 @@ extern struct Result build_to_string(char* filePath, char* cacheQueryString, cha
 //
 extern struct Result resolve(char* filePath, char* configJson);
 
+// Compile assets using the given `config`.
+//
+// - config
+//
+extern struct CompileResult compile(char* configJson);
+
 #ifdef __cplusplus
 }
 #endif

data/lib/proscenium/helper.rb

@@ -11,18 +11,9 @@ module Proscenium
       end
     end
 
-    # Overriden to allow regular use of javascript_include_tag and stylesheet_link_tag, while still
-    # building with Proscenium. It's important to note that `include_assets` will not call this, as
-    # those asset paths all begin with a slash, which the Rails asset helpers do not pass through to
-    # here.
-    #
-    # If the given `path` is a bare path (does not start with `./` or `../`), then we use
-    # Rails default conventions, and serve CSS from /app/assets/stylesheets and JS from
-    # /app/javascript.
     def compute_asset_path(path, options = {})
       if %i[javascript stylesheet].include?(options[:type])
-        path.prepend DEFAULT_RAILS_ASSET_PATHS[options[:type]] if !path.start_with?('./', '../')
-        return path
+        return Proscenium::Manifest[path] || "/#{path}"
       end
 
       super

data/lib/proscenium/manifest.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Proscenium
+  module Manifest
+    mattr_accessor :manifest, default: {}
+    mattr_accessor :loaded, default: false
+
+    module_function
+
+    def loaded?
+      loaded
+    end
+
+    def load!
+      self.manifest = {}
+      self.loaded = false
+
+      if Proscenium.config.manifest_path.exist?
+        self.loaded = true
+
+        JSON.parse(Proscenium.config.manifest_path.read)['outputs'].each do |output_path, details|
+          next if !details.key?('entryPoint')
+
+          manifest[details['entryPoint']] = "/#{output_path.delete_prefix('public/')}"
+        end
+      end
+
+      manifest
+    end
+
+    def reset!
+      self.manifest = {}
+      self.loaded = false
+    end
+
+    def [](key)
+      loaded? ? manifest[key] : "/#{key}"
+    end
+  end
+end

data/lib/proscenium/middleware/base.rb

@@ -5,18 +5,6 @@ module Proscenium
     class Base
       include ActiveSupport::Benchmarkable
 
-      # Error when the result of the build returns an error. For example, when esbuild returns
-      # errors.
-      class CompileError < StandardError
-        attr_reader :detail, :file
-
-        def initialize(args)
-          @detail = args[:detail]
-          @file = args[:file]
-          super("Failed to build '#{args[:file]}' -- #{detail}")
-        end
-      end
-
       def self.attempt(request)
         new(request).renderable!&.attempt
       end
@@ -40,17 +28,6 @@ module Proscenium
         @path_to_build ||= @request.path[1..]
       end
 
-      def cache_query_string
-        @cache_query_string ||= begin
-          params = @request.query_parameters
-          if params.one? && params.first[0] != '' && params.first[1].nil?
-            params.keys.first
-          else
-            Proscenium.config.cache_query_string
-          end
-        end.presence || ''
-      end
-
       def sourcemap?
         @request.path.ends_with?('.map')
       end
@@ -97,10 +74,6 @@ module Proscenium
         response.content_type = content_type
         response.etag = result[:content_hash]
 
-        if !cache_query_string.blank? && Proscenium.config.cache_max_age
-          response.cache! Proscenium.config.cache_max_age
-        end
-
         if @request.fresh?(response)
           response.status = 304
           response.body = []

data/lib/proscenium/middleware/chunks.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Proscenium
+  class Middleware
+    class Chunks
+      def initialize(app)
+        @app = app
+      end
+
+      def call(env)
+        request = ActionDispatch::Request.new(env)
+
+        return @app.call(env) unless request.path.match?(CHUNKS_PATH)
+
+        ActionDispatch::FileHandler.new(
+          Proscenium.config.output_path.to_s,
+          headers: {
+            'X-Proscenium-Middleware' => 'chunks',
+            'SourceMap' => "#{request.path}.map",
+            'Cache-Control' => "public, max-age=#{100.years}, immutable",
+            'ETag' => request.path.match(/-\$([a-z0-9]+)\$/i)[1]
+          }
+        ).attempt(request.env) || @app.call(env)
+      end
+    end
+  end
+end

data/lib/proscenium/middleware/esbuild.rb

@@ -3,26 +3,8 @@
 module Proscenium
   class Middleware
     class Esbuild < Base
-      class CompileError < Base::CompileError
-        def initialize(args)
-          detail = args[:detail]
-          detail = JSON.parse(detail, mode: :strict)
-
-          args['detail'] = if detail['location']
-                             "#{detail['text']} in #{detail['location']['file']}:" +
-                               detail['location']['line'].to_s
-                           else
-                             detail['text']
-                           end
-
-          super
-        end
-      end
-
       def attempt
-        render_response Builder.build_to_string(path_to_build, cache_query_string:)
-      rescue Builder::CompileError => e
-        raise self.class::CompileError, { file: @request.fullpath, detail: e.message }, caller
+        render_response Builder.build_to_string(path_to_build)
       end
     end
   end

data/lib/proscenium/middleware/vendor.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Proscenium
+  class Middleware
+    class Vendor
+      def initialize(app)
+        @app = app
+      end
+
+      def call(env)
+        request = ActionDispatch::Request.new(env)
+        pathname = Pathname.new(request.path)
+
+        return @app.call(env) unless pathname.fnmatch?(VENDOR_PATH_GLOB, File::FNM_EXTGLOB)
+
+        request.path_info = request.path.delete_prefix('/vendor')
+
+        ActionDispatch::FileHandler.new(
+          Rails.root.join('vendor').to_s,
+          headers: {
+            'X-Proscenium-Middleware' => 'vendor',
+            'Cache-Control' => "public, max-age=#{100.years}, immutable"
+          }
+        ).attempt(request.env) || @app.call(env)
+      end
+    end
+  end
+end

data/lib/proscenium/middleware.rb

@@ -4,11 +4,13 @@ module Proscenium
   class Middleware
     extend ActiveSupport::Autoload
 
-    class BuildError < StandardError; end
+    class BuildError < Error; end
 
     autoload :Base
     autoload :Esbuild
     autoload :RubyGems
+    autoload :Vendor
+    autoload :Chunks
     autoload :SilenceRequest
 
     def initialize(app)
@@ -20,19 +22,7 @@ module Proscenium
 
       return @app.call(env) if !request.get? && !request.head?
 
-      # If this is a request for an asset chunk, we want to serve it with a very long
-      # cache lifetime, since these are content-hashed and will never change.
-      if request.path.match?(CHUNKS_PATH)
-        ::ActionDispatch::FileHandler.new(
-          Rails.public_path.join('assets').to_s,
-          headers: {
-            'Cache-Control' => "public, max-age=#{100.years}, immutable",
-            'etag' => request.path.match(/-\$([a-z0-9]+)\$/i)[1]
-          }
-        ).attempt(env) || @app.call(env)
-      else
-        attempt(request) || @app.call(env)
-      end
+      attempt(request) || @app.call(env)
     end
 
     private
@@ -40,7 +30,7 @@ module Proscenium
     def attempt(request)
       return unless (type = find_type(request))
 
-      type.attempt request
+      type.attempt(request)
     end
 
     def find_type(request)

data/lib/proscenium/railtie.rb

@@ -15,10 +15,10 @@ module Proscenium
     config.proscenium.side_load = true
     config.proscenium.code_splitting = true
     config.proscenium.ensure_loaded = :raise
-    config.proscenium.cache_query_string = Rails.env.production? && ENV.fetch('REVISION', nil)
-    config.proscenium.cache_max_age = 2_592_000 # 30 days
-
     config.proscenium.aliases = {}
+    config.proscenium.external = Set['*.rjs', '*.gif', '*.jpg', '*.png', '*.woff2', '*.woff']
+    config.proscenium.precompile = Set.new
+    config.proscenium.output_dir = '/assets'
 
     # List of environment variable names that should be passed to the builder, which will then be
     # passed to esbuild's `Define` option. Being explicit about which environment variables are
@@ -29,7 +29,13 @@ module Proscenium
       'Proscenium::Builder::BuildError' => 'build_error'
     }
 
-    config.after_initialize do |_app|
+    config.after_initialize do |app|
+      config.proscenium.output_path ||=
+        Pathname.new(File.join(app.config.paths['public'].first, app.config.proscenium.output_dir))
+      config.proscenium.manifest_path = config.proscenium.output_path.join('.manifest.json')
+
+      Proscenium::Manifest.load!
+
       if config.proscenium.logging
         require 'proscenium/log_subscriber'
         Proscenium::LogSubscriber.attach_to :proscenium
@@ -49,7 +55,18 @@ module Proscenium
       unless config.proscenium.logging
         app.middleware.insert_before Rails::Rack::Logger, Proscenium::Middleware::SilenceRequest
       end
-      app.middleware.insert_before ActionDispatch::ActionableExceptions, Proscenium::Middleware
+
+      app.middleware.insert_after Rack::Sendfile, Proscenium::Middleware::Vendor
+      app.middleware.insert_after Rack::Sendfile, Proscenium::Middleware::Chunks
+
+      # Ensure the middleware is inserted as early as possible.
+      if app.config.consider_all_requests_local
+        app.middleware.insert_before ActionDispatch::ActionableExceptions, Proscenium::Middleware
+      elsif app.config.reloading_enabled?
+        app.middleware.insert_before ActionDispatch::Reloader, Proscenium::Middleware
+      else
+        app.middleware.insert_before ActionDispatch::Callbacks, Proscenium::Middleware
+      end
     end
 
     initializer 'proscenium.sideloading' do
@@ -65,5 +82,9 @@ module Proscenium
         ActionView::PartialRenderer.prepend Monkey::PartialRenderer
       end
     end
+
+    rake_tasks do
+      load 'proscenium/railties/assets.rake'
+    end
   end
 end

data/lib/proscenium/railties/assets.rake

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+namespace :assets do
+  desc 'Compile Proscenium assets'
+  task precompile: :environment do
+    puts "\nPre-compiling assets..."
+
+    raise 'Assets pre-compilation failed!' unless Proscenium::Builder.compile
+
+    puts "\nAssets pre-compiled successfully."
+
+    if Rails.env.development?
+      puts "\nWarning: You are precompiling assets in development. Rails will not " \
+           'serve any changed assets until you delete ' \
+           "public#{Rails.application.config.proscenium.output_dir}/.manifest.json"
+    end
+  end
+end

data/lib/proscenium/side_load.rb

@@ -40,10 +40,7 @@ module Proscenium
           opts[:preload_links_header] = false if fragments
           opts[:data] ||= {}
 
-          if Proscenium.config.cache_query_string.present?
-            path += "?#{Proscenium.config.cache_query_string}"
-          end
-          out << helpers.stylesheet_link_tag(path, extname: false, **opts)
+          out << helpers.stylesheet_link_tag(path.delete_prefix('/'), extname: false, **opts)
         end
 
         if fragments
@@ -71,10 +68,7 @@ module Proscenium
           opts = opts[:js].is_a?(Hash) ? opts[:js] : {}
           opts[:preload_links_header] = false if fragments
 
-          if Proscenium.config.cache_query_string.present?
-            path += "?#{Proscenium.config.cache_query_string}"
-          end
-          out << helpers.javascript_include_tag(path, extname: false, **opts)
+          out << helpers.javascript_include_tag(path.delete_prefix('/'), extname: false, **opts)
         end
 
         if fragments

data/lib/proscenium/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Proscenium
-  VERSION = '0.21.6'
+  VERSION = '0.22.0'
 end

data/lib/proscenium.rb

@@ -14,7 +14,8 @@ module Proscenium
 
   FILE_EXTENSIONS = ['js', 'mjs', 'ts', 'jsx', 'tsx', 'css', 'js.map', 'mjs.map', 'jsx.map',
                      'ts.map', 'tsx.map', 'css.map'].freeze
-  ALLOWED_DIRECTORIES = 'app,lib,config,vendor,node_modules'
+  ALLOWED_DIRECTORIES = 'app,lib,config,node_modules'
+  VENDOR_PATH_GLOB = '/vendor/**.{js,css}'
   APP_PATH_GLOB = "/{#{ALLOWED_DIRECTORIES}}/**.{#{FILE_EXTENSIONS.join(',')}}".freeze
   GEMS_PATH_GLOB = "/node_modules/@rubygems/**.{#{FILE_EXTENSIONS.join(',')}}".freeze
   CHUNKS_PATH = %r{^/_asset_chunks/}
@@ -26,6 +27,7 @@ module Proscenium
   autoload :Utils
   autoload :Monkey
   autoload :Middleware
+  autoload :Manifest
   autoload :EnsureLoaded
   autoload :SideLoad
   autoload :CssModule
@@ -44,7 +46,20 @@ module Proscenium
     end
   end
 
-  class PathResolutionFailed < StandardError
+  class Error < StandardError; end
+
+  class MissingAssetError < Error
+    def initialize(path)
+      super
+      @path = path
+    end
+
+    def message
+      "The asset '#{@path}' was not found."
+    end
+  end
+
+  class PathResolutionFailed < Error
     def initialize(path)
       @path = path
       super

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: proscenium
 version: !ruby/object:Gem::Version
-  version: 0.21.6
+  version: 0.22.0
 platform: arm64-darwin
 authors:
 - Joel Moss
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-24 00:00:00.000000000 Z
+date: 2025-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -66,13 +66,17 @@ files:
 - lib/proscenium/helper.rb
 - lib/proscenium/importer.rb
 - lib/proscenium/log_subscriber.rb
+- lib/proscenium/manifest.rb
 - lib/proscenium/middleware.rb
 - lib/proscenium/middleware/base.rb
+- lib/proscenium/middleware/chunks.rb
 - lib/proscenium/middleware/esbuild.rb
 - lib/proscenium/middleware/ruby_gems.rb
 - lib/proscenium/middleware/silence_request.rb
+- lib/proscenium/middleware/vendor.rb
 - lib/proscenium/monkey.rb
 - lib/proscenium/railtie.rb
+- lib/proscenium/railties/assets.rake
 - lib/proscenium/react-manager/index.jsx
 - lib/proscenium/react-manager/react.js
 - lib/proscenium/react_componentable.rb