proscenium 0.23.0-aarch64-linux → 0.24.1-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9fca5d3c15df8bca393f34a3797bc4c28b9e6a56dbb16deeec3e779b7a7cd6a
-  data.tar.gz: 401c4d4b642ac38e2dea04d2be60942960074941cfd50d91a231876e598e1930
+  metadata.gz: 9a3c2342c13ecc8f74633f806e135140427f37e9886433c2c9c12984823c3d44
+  data.tar.gz: d16c89353c53a1379941cc5f916d617012bd0d55da2b7cb956b05d22b40433b9
 SHA512:
-  metadata.gz: 999e249ee74c1e36825bacd392396840b286e045ace096b2e8661cad3c33ed33b3937ab38c636ad414f2ff583f9d77c165df0729b774cda0a63462dd72095ac5
-  data.tar.gz: cb0e5986bb38ac53bde5e2813fad938f06906d9c6a911513f4332ed971c0c9750612343a22e33249a7ac083f9f7ac4e0ddf8e1e0291abe77a3f0f89ff0e4e68a
+  metadata.gz: 2ca84ecb37b878d95afec420a3168e3861bd88ef4e1b4baa5ddf3e270cf849dd2d9e317dad84a3ade7aaebeb84e28d34c4e5c221907dfab0ef8e6ed068c5329c
+  data.tar.gz: 8ba34b73a200991c2a23a3e33a755c8d6b205314a5e6111d4ee8925d265397e3ae6a8ada9cabed38b55250e8266ba3eb1f7a7a9214518be2bdb2e001f59f56bd

data/README.md

@@ -36,6 +36,7 @@
 - [JavaScript](#javascript)
   - [Tree Shaking](#tree-shaking)
   - [Code Splitting](#code-splitting)
+  - [`__filename` and `__dirname`](#__filename-and-__dirname)
   - [JavaScript Caveats](#javascript-caveats)
 - [CSS](#css)
   - [Importing CSS from JavaScript](#importing-css-from-javascript)
@@ -57,11 +58,9 @@
 
 Getting started obviously depends on whether you are adding Proscenium to an existing Rails app, or creating a new one. So choose the appropriate guide below:
 
-- [Getting Started with a new Rails app](https://github.com/joelmoss/proscenium/blob/master/docs/guides/new_rails_app.md)
+- [Getting Started with a new Rails app](docs/guides/new_rails_app.md)
 - Getting Started with an existing Rails app
   - [Migrate from Sprockets](docs/guides/migrate_from_sprockets.md)
-  - Migrate from Propshaft _[Coming soon]_
-  - Migrate from Webpacker _[Coming soon]_
 - [Render a React component with Proscenium](docs/guides/basic_react.md)
 
 ## Installation
@@ -158,7 +157,7 @@ Let's continue with our problem example above, where we have the following asset
 - `/app/assets/users.js`
 - `/app/assets/user.js`
 
-Your application layout is at `/app/views/layouts/application.hml.erb`, and the view that needs the users assets is at `/app/views/users/index.html.erb`, so move your assets JS and CSS alongside them:
+Your application layout is at `/app/views/layouts/application.html.erb`, and the view that needs the users assets is at `/app/views/users/index.html.erb`, so move your assets JS and CSS alongside them:
 
 - `/app/views/layouts/application.css`
 - `/app/views/layouts/application.js`
@@ -297,8 +296,6 @@ You can import SVG from JS(X), which will bundle the SVG source code. Additional
 
 ## Environment Variables
 
-> Available in `>=0.10.0`
-
 You can define and access any environment variable from your JavaScript and Typescript under the `proscenium.env` namespace.
 
 For performance and security reasons you must declare the environment variable names that you wish to expose in your `config/application.rb` file.
@@ -442,6 +439,26 @@ Code splitting is enabled by default. You can disable it by setting the `code_sp
 config.proscenium.code_splitting = false
 ```
 
+### `__filename` and `__dirname`
+
+Proscenium provides Node.js-style `__filename` and `__dirname` constants in your JavaScript and TypeScript files. These are replaced at build time with the root-relative path of the current file and its directory respectively.
+
+```js
+// /app/views/users/index.js
+console.log(__filename); // "/app/views/users/index.js"
+console.log(__dirname); // "/app/views/users"
+```
+
+Files inside Ruby gems resolve to their `@rubygems/` scoped path:
+
+```js
+// Inside the "mygem" gem
+console.log(__filename); // "@rubygems/mygem/lib/mygem/component.js"
+console.log(__dirname); // "@rubygems/mygem/lib/mygem"
+```
+
+Note that `__filename` and `__dirname` are not injected into files within `node_modules`.
+
 ### JavaScript Caveats
 
 There are a few important caveats as far as JavaScript is concerned. These are [detailed on the esbuild site](https://esbuild.github.io/content-types/#javascript-caveats).
@@ -458,7 +475,9 @@ Proscenium will also automatically insert vendor prefixes so that your CSS will
 
 ### Importing CSS from JavaScript
 
-You can also import CSS from JavaScript. When you do this, Proscenium will automatically append each stylesheet to the document's head as a `<link>` element.
+You can also import CSS from JavaScript. When you do this, Proscenium will automatically append each stylesheet to the document's head as a `<style>` element.
+
+If your page includes a `<meta name="csp-nonce" content="...">` tag, the injected `<style>` elements will automatically pick up the nonce value for Content Security Policy compliance.
 
 ```jsx
 import "./button.css";

data/lib/proscenium/css_module/transformer.rb

@@ -33,31 +33,22 @@ module Proscenium
     #   class_names "mypackage/button@large"
     #   class_names "@scoped/package/button@small"
     #
+    # When a block is given, it is yielded once per input name with
+    # `(transformed_name, side_load_path)`. `side_load_path` is the exact string passed to
+    # `Importer.import` for that name, or `nil` for names that did not trigger a side-load (plain
+    # class names with `require_prefix: true`). The return value is unchanged — callers that don't
+    # need the path can keep ignoring the block.
+    #
     # @param names [String,Symbol,Array<String,Symbol>]
     # @param require_prefix: [Boolean] whether or not to require the `@` prefix.
+    # @yieldparam transformed_name [String]
+    # @yieldparam side_load_path [String, nil]
     # @return [Array<String>] the transformed CSS module names.
     def class_names(*names, require_prefix: true)
       names.map do |name|
-        original_name = name.dup
-        name = name.to_s if name.is_a?(Symbol)
-
-        if name.include?('/')
-          if name.start_with?('@')
-            # Scoped bare specifier (eg. "@scoped/package/lib/button@default").
-            _, path, name = name.split('@')
-            path = "@#{path}"
-          else
-            # Local path (eg. /some/path/to/button@default") or bare specifier (eg.
-            # "mypackage/lib/button@default").
-            path, name = name.split('@')
-          end
-
-          class_name! name, original_name, path: "#{path}#{FILE_EXT}"
-        elsif name.start_with?('@')
-          class_name! name[1..], original_name
-        else
-          require_prefix ? name : class_name!(name, original_name)
-        end
+        transformed, path = transform_class_name(name, require_prefix: require_prefix)
+        yield(transformed, path) if block_given?
+        transformed
       end
     end
 
@@ -75,5 +66,38 @@ module Proscenium
         "#{transformed_name}_#{digest}"
       end
     end
+
+    private
+
+    # Returns `[transformed_name, side_load_path]` for a single class-name reference.
+    # `side_load_path` is the exact string that `class_name!` passed to `Importer.import`, or
+    # `nil` if the name did not trigger a side-load. Extracted so `#class_names` can yield paths
+    # to consumers (e.g. proscenium-phlex's `resolved_css_module_paths` replay registry) without
+    # re-parsing names.
+    def transform_class_name(name, require_prefix:)
+      original_name = name.dup
+      name = name.to_s if name.is_a?(Symbol)
+
+      if name.include?('/')
+        if name.start_with?('@')
+          # Scoped bare specifier (eg. "@scoped/package/lib/button@default").
+          _, path, name = name.split('@')
+          path = "@#{path}"
+        else
+          # Local path (eg. /some/path/to/button@default") or bare specifier (eg.
+          # "mypackage/lib/button@default").
+          path, name = name.split('@')
+        end
+
+        module_path = "#{path}#{FILE_EXT}"
+        [class_name!(name, original_name, path: module_path), module_path]
+      elsif name.start_with?('@')
+        [class_name!(name[1..], original_name), @source_path&.to_s]
+      elsif require_prefix
+        [name, nil]
+      else
+        [class_name!(name, original_name), @source_path&.to_s]
+      end
+    end
   end
 end

data/lib/proscenium/ensure_loaded.rb

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

data/lib/proscenium/ext/proscenium.h

@@ -101,25 +101,8 @@ extern "C" {
 #endif
 
 extern void reset_config(void);
-
-// Build the given `path` using the `config`.
-//
-// - path - The path to build relative to `root`.
-// - config
-//
 extern struct Result build_to_string(char* filePath, char* configJson);
-
-// Resolve the given `path` relative to the `root`.
-//
-// - path - The path to build relative to `root`.
-// - config
-//
 extern struct ResolveResult resolve(char* filePath, char* configJson);
-
-// Compile assets using the given `config`.
-//
-// - config
-//
 extern struct CompileResult compile(char* configJson);
 
 #ifdef __cplusplus

data/lib/proscenium/importer.rb

@@ -30,9 +30,9 @@ module Proscenium
         digest = nil
 
         if filepath.end_with?('.module.css')
-          if self.imported.key?(filepath)
-            digest = self.imported[filepath][:digest]
-            abs_path = self.imported[filepath][:abs_path]
+          if imported.key?(filepath)
+            digest = imported[filepath][:digest]
+            abs_path = imported[filepath][:abs_path]
           else
             manifest_path, non_manifest_path, abs_path = Resolver.resolve(filepath, as_array: true)
             digest = Utils.css_module_digest(abs_path)
@@ -41,14 +41,14 @@ module Proscenium
             if sideloaded
               ActiveSupport::Notifications.instrument 'sideload.proscenium', identifier: filepath,
                                                                              sideloaded: do
-                self.imported[filepath] = { ** }
-                self.imported[filepath][:digest] = digest
-                self.imported[filepath][:abs_path] = abs_path
+                imported[filepath] = { ** }
+                imported[filepath][:digest] = digest
+                imported[filepath][:abs_path] = abs_path
               end
             else
-              self.imported[filepath] = { ** }
-              self.imported[filepath][:digest] = digest
-              self.imported[filepath][:abs_path] = abs_path
+              imported[filepath] = { ** }
+              imported[filepath][:digest] = digest
+              imported[filepath][:abs_path] = abs_path
             end
           end
 
@@ -60,16 +60,16 @@ module Proscenium
 
           "#{digest}#{transformed_path}"
         else
-          return if self.imported.key?(filepath)
+          return if imported.key?(filepath)
 
           Array(Resolver.resolve(filepath)).each do |fp|
             if sideloaded
               ActiveSupport::Notifications.instrument 'sideload.proscenium', identifier: fp,
                                                                              sideloaded: do
-                self.imported[fp] = { ** }
+                imported[fp] = { ** }
               end
             else
-              self.imported[fp] = { ** }
+              imported[fp] = { ** }
             end
           end
         end

data/lib/proscenium/version.rb

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

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: proscenium
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.24.1
 platform: aarch64-linux
 authors:
 - Joel Moss
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -44,7 +43,6 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
-description:
 email:
 - joel@developwithstyle.com
 executables: []
@@ -94,7 +92,6 @@ metadata:
   source_code_uri: https://github.com/joelmoss/proscenium
   changelog_uri: https://github.com/joelmoss/proscenium/releases
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -109,8 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: The engine powering your Rails frontend
 test_files: []