proscenium 0.11.0.pre.13-arm64-darwin → 0.13.0-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e194150bceddde6ff022e44c289dc906cbad5210c12abe16534dfa569543d1bb
-  data.tar.gz: 70b60910b4a8170698cb1ed89dd75841274b719671fbae683892e57561d1998f
+  metadata.gz: 504d8ab4fde95d64a7800b7406ac1cb5e9de3757277729bd64f84a80a89d0363
+  data.tar.gz: 9dac30d044bac3f9c3c8b6a82721072dbe58a540a36d6538cc3ae29eea31a2ba
 SHA512:
-  metadata.gz: 8120adfdf45a1ec565730f4075b313ad7f78e1bf246eafd6597007423af9169de4c6e605be6d78d672445b1fb33fa207db66d72d6360e03303c883b9b7ff866f
-  data.tar.gz: 5577d1d5952c57b9260d33a8f29231a88d69aafccd265438c04345a848214edc0de1694ccf2665cfe7bd6a57b05d0213a3774938d0797252d19c65ffca797c60
+  metadata.gz: b828294555e4ed9a3f9875785d09193266b7de9d07cbda5bf3cafe06eff2e3825600dbf6539821c6ffd8f792aba3305b877c174c2337fca6563c7cc9bb6a2849
+  data.tar.gz: 37e577a37203199fdf55eb560521e0f1b5f47ad854ee19f147ab372792a6811a4eef86ea8faa7ddd9a6330b31c7d40ddbd0f90e7804044e31fa205eef1fa4ad9

data/README.md

@@ -46,7 +46,8 @@ Proscenium treats your client-side code as first class citizens of your Rails ap
 - [ViewComponent Support](#viewcomponent-support)
 - [Cache Busting](#cache-busting)
 - [rjs is back!](#rjs-is-back)
-- [Included Paths](#included-paths)
+- [Resolution](#resolution)
+  - [Assets from Rails Engines](#assets-from-rails-engines)
 - [Thanks](#thanks)
 - [Development](#development)
 
@@ -227,6 +228,42 @@ import utils from '/lib/utils'
 import constants from './constants'
 ```
 
+```css /app/views/layouts/application.css
+@import '/lib/reset';
+```
+
+```css /lib/reset.css
+body {
+  /* some styles... */
+}
+```
+
+### Unbundling
+
+Sometimes you don't want to bundle an import. For example, you want to ensure that only one instance of React is loaded. In this cases, you can use the `unbundle` prefix
+
+```js
+import React from 'unbundle:react'
+```
+
+This only works any bare and local imports.
+
+You can also use the `unbundle` prefix in your import map, which ensures that all imports of a particular path is always unbundled:
+
+```json
+{
+  "imports": {
+    "react": "unbundle:react"
+  }
+}
+```
+
+Then just import as normal:
+
+```js
+import React from 'react'
+```
+
 ## Import Maps
 
 > **[WIP]**
@@ -515,6 +552,13 @@ css_module 'mypackage/button@big_button'
 # => "big_button"
 ```
 
+`css_module` also accepts a `path` keyword argument, which allows you to specify the path to the CSS
+file. Note that this will use the given path for all class names passed to that instance of `css_module`.
+
+```ruby
+css_module :my_module_name, path: Rails.root.join('app/components/button.css')
+```
+
 #### In your JavaScript
 
 Importing a CSS module from JS will automatically append the stylesheet to the document's head. And the result of the import will be an object of CSS class to module names.
@@ -634,6 +678,27 @@ class MyView < Proscenium::Phlex
 end
 ```
 
+In your layouts, include `Proscenium::Phlex::AssetInclusions`, and call the `include_assets` helper.
+
+```ruby
+class ApplicationLayout < Proscenium::Phlex
+  include Proscenium::Phlex::AssetInclusions
+
+  def template(&)
+    doctype
+    html do
+      head do
+        title { 'My Awesome App' }
+        include_assets
+      end
+      body(&)
+    end
+  end
+end
+```
+
+You can specifically include CCS and JS assets using the `include_stylesheets` and `include_javascripts` helpers, allowing you to control where they are included in the HTML.
+
 ### Side-loading
 
 Any Phlex class that inherits `Proscenium::Phlex` will automatically be [side-loaded](#side-loading).

data/lib/proscenium/css_module.rb

@@ -18,8 +18,20 @@ module Proscenium::CssModule
   # Accepts one or more CSS class names, and transforms them into CSS module names.
   #
   # @param name [String,Symbol,Array<String,Symbol>]
-  def css_module(*names)
-    cssm.class_names(*names, require_prefix: false).map { |name, _| name }.join(' ')
+  # @param path [Pathname] the path to the CSS module file to use for the transformation.
+  # @return [String] the transformed CSS module names concatenated as a string.
+  def css_module(*names, path: nil)
+    transformer = path.nil? ? cssm : Transformer.new(path)
+    transformer.class_names(*names, require_prefix: false).map { |name, _| name }.join(' ')
+  end
+
+  # @param name [String,Symbol,Array<String,Symbol>]
+  # @param path [Pathname] the path to the CSS file to use for the transformation.
+  # @return [String] the transformed CSS module names concatenated as a string.
+  def class_names(*names, path: nil)
+    names = names.flatten.compact
+    transformer = path.nil? ? cssm : Transformer.new(path)
+    transformer.class_names(*names).map { |name, _| name }.join(' ') unless names.empty?
   end
 
   private

data/lib/proscenium/helper.rb

@@ -20,11 +20,24 @@ module Proscenium
     #
     # @see CssModule::Transformer#class_names
     # @param name [String,Symbol,Array<String,Symbol>]
-    def css_module(*names)
-      path = Pathname.new(@lookup_context.find(@virtual_path).identifier).sub_ext('')
-      CssModule::Transformer.new(path).class_names(*names, require_prefix: false).map do |name, _|
-        name
-      end.join(' ')
+    # @param path [Pathname] the path to the CSS module file to use for the transformation.
+    # @return [String] the transformed CSS module names concatenated as a string.
+    def css_module(*names, path: nil)
+      path ||= Pathname.new(@lookup_context.find(@virtual_path).identifier).sub_ext('')
+      CssModule::Transformer.new(path).class_names(*names, require_prefix: false)
+                            .map { |name, _| name }.join(' ')
+    end
+
+    # @param name [String,Symbol,Array<String,Symbol>]
+    # @param path [Pathname] the path to the CSS file to use for the transformation.
+    # @return [String] the transformed CSS module names concatenated as a string.
+    def class_names(*names, path: nil)
+      names = names.flatten.compact
+
+      return if names.empty?
+
+      path ||= Pathname.new(@lookup_context.find(@virtual_path).identifier).sub_ext('')
+      CssModule::Transformer.new(path).class_names(*names).map { |name, _| name }.join(' ')
     end
 
     def include_stylesheets(**options)

data/lib/proscenium/importer.rb

@@ -79,14 +79,25 @@ module Proscenium
       def each_stylesheet(delete: false)
         return if imported.blank?
 
-        blk = proc { |key, options| key.end_with?(*CSS_EXTENSIONS) && yield(key, options) }
+        blk = proc do |key, options|
+          if key.end_with?(*CSS_EXTENSIONS)
+            yield(key, options)
+            true
+          end
+        end
+
         delete ? imported.delete_if(&blk) : imported.each(&blk)
       end
 
       def each_javascript(delete: false)
         return if imported.blank?
 
-        blk = proc { |key, options| key.end_with?(*JS_EXTENSIONS) && yield(key, options) }
+        blk = proc do |key, options|
+          if key.end_with?(*JS_EXTENSIONS)
+            yield(key, options)
+            true
+          end
+        end
         delete ? imported.delete_if(&blk) : imported.each(&blk)
       end
 

data/lib/proscenium/phlex/asset_inclusions.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Proscenium::Phlex::AssetInclusions
+  include Phlex::Rails::Helpers::ContentFor
+  include Phlex::Rails::Helpers::StyleSheetPath
+  include Phlex::Rails::Helpers::JavaScriptPath
+
+  def include_stylesheets
+    comment { '[PROSCENIUM_STYLESHEETS]' }
+  end
+
+  def include_javascripts(defer_lazy_scripts: false)
+    comment { '[PROSCENIUM_JAVASCRIPTS]' }
+    !defer_lazy_scripts && include_lazy_javascripts
+  end
+
+  def include_lazy_javascripts
+    comment { '[PROSCENIUM_LAZY_SCRIPTS]' }
+  end
+
+  def include_assets(defer_lazy_scripts: false)
+    include_stylesheets
+    include_javascripts(defer_lazy_scripts: defer_lazy_scripts)
+  end
+
+  def after_template
+    super
+
+    @_buffer.gsub! '<!-- [PROSCENIUM_STYLESHEETS] -->', capture_stylesheets!
+    @_buffer.gsub! '<!-- [PROSCENIUM_JAVASCRIPTS] -->', capture_javascripts!
+
+    if content_for?(:proscenium_lazy_scripts)
+      flush
+      @_buffer.gsub!('<!-- [PROSCENIUM_LAZY_SCRIPTS] -->', capture do
+        content_for(:proscenium_lazy_scripts)
+      end)
+    else
+      @_buffer.gsub! '<!-- [PROSCENIUM_LAZY_SCRIPTS] -->', ''
+    end
+  end
+
+  private
+
+  def capture_stylesheets!
+    capture do
+      Proscenium::Importer.each_stylesheet(delete: true) do |path, _path_options|
+        link rel: 'stylesheet', href: stylesheet_path(path, extname: false)
+      end
+    end
+  end
+
+  def capture_javascripts! # rubocop:disable Metrics/*
+    unless Rails.application.config.proscenium.code_splitting &&
+           Proscenium::Importer.multiple_js_imported?
+      return capture do
+        Proscenium::Importer.each_javascript(delete: true) do |path, _|
+          script(src: javascript_path(path, extname: false), type: :module)
+        end
+      end
+    end
+
+    imports = Proscenium::Importer.imported.dup
+    paths_to_build = []
+    Proscenium::Importer.each_javascript(delete: true) do |x, _|
+      paths_to_build << x.delete_prefix('/')
+    end
+
+    result = Proscenium::Builder.build(paths_to_build.join(';'), base_url: helpers.request.base_url)
+
+    # Remove the react components from the results, so they are not side loaded. Instead they
+    # are lazy loaded by the component manager.
+
+    capture do
+      scripts = {}
+      result.split(';').each do |x|
+        inpath, outpath = x.split('::')
+        inpath.prepend '/'
+        outpath.delete_prefix! 'public'
+
+        next unless imports.key?(inpath)
+
+        if (import = imports[inpath]).delete(:lazy)
+          scripts[inpath] = import.merge(outpath: outpath)
+        else
+          script(src: javascript_path(outpath, extname: false), type: :module)
+        end
+      end
+
+      content_for :proscenium_lazy_scripts do
+        script type: 'application/json', id: 'prosceniumLazyScripts' do
+          unsafe_raw scripts.to_json
+        end
+      end
+    end
+  end
+end

data/lib/proscenium/phlex.rb

@@ -8,19 +8,11 @@ module Proscenium
 
     autoload :CssModules
     autoload :ReactComponent
+    autoload :AssetInclusions
 
-    extend ::Phlex::Rails::HelperMacros
-    include ::Phlex::Rails::Helpers::JavaScriptIncludeTag
-    include ::Phlex::Rails::Helpers::StyleSheetLinkTag
     include Proscenium::SourcePath
     include CssModules
 
-    define_output_helper :side_load_stylesheets # deprecated
-    define_output_helper :include_stylesheets
-    define_output_helper :side_load_javascripts # deprecated
-    define_output_helper :include_javascripts
-    define_output_helper :declare_lazy_scripts
-
     module Sideload
       def before_template
         Proscenium::SideLoad.sideload_inheritance_chain self

data/lib/proscenium/railtie.rb

@@ -54,8 +54,8 @@ module Proscenium
 
     initializer 'proscenium.middleware' do |app|
       app.middleware.insert_after ActionDispatch::Static, Middleware
-      # app.middleware.insert_after ActionDispatch::Static, Rack::ETag, 'no-cache'
-      # app.middleware.insert_after ActionDispatch::Static, Rack::ConditionalGet
+      app.middleware.insert_after ActionDispatch::Static, Rack::ETag, 'no-cache'
+      app.middleware.insert_after ActionDispatch::Static, Rack::ConditionalGet
     end
 
     initializer 'proscenium.monkey_patches' do

data/lib/proscenium/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Proscenium
-  VERSION = '0.11.0.pre.13'
+  VERSION = '0.13.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: proscenium
 version: !ruby/object:Gem::Version
-  version: 0.11.0.pre.13
+  version: 0.13.0
 platform: arm64-darwin
 authors:
 - Joel Moss
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-12 00:00:00.000000000 Z
+date: 2023-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -111,6 +111,7 @@ files:
 - lib/proscenium/middleware/url.rb
 - lib/proscenium/monkey.rb
 - lib/proscenium/phlex.rb
+- lib/proscenium/phlex/asset_inclusions.rb
 - lib/proscenium/phlex/css_modules.rb
 - lib/proscenium/phlex/react_component.rb
 - lib/proscenium/railtie.rb
@@ -144,11 +145,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.4.20
+rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
 summary: The engine powering your Rails frontend