svelte-on-rails 3.1.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2851a32bc97ac4fc669189927f2493976a029b21ed724cd90b0f0832e90bb0b4
-  data.tar.gz: fecead1bb111cd3a5e504350c0123d689f08eacc452d6421d159e1e2a0c53685
+  metadata.gz: a8c8933b55b56b0a2adcc4c06542b0a9078b8e36408ae6afc9316289f2f2f924
+  data.tar.gz: 777395f46db7c8e2c88df9090b646088e39cb10cf9c2881ff7cd2f7a78dc8065
 SHA512:
-  metadata.gz: 610aa41d2d4a964a216db1459b42eb37fe57d20750777e3c6f811f0e8275df327b04690a3c70405c61729e11055bb5939c578ea28942f96ff143de3639039c38
-  data.tar.gz: 021dbaff2383180c544430c66f02759d05eeacf79c2d800e87201de212722aac3666458dab96d877b2768e5c49f3f543374d38ba641a2098cdaa1b8ae615f137
+  metadata.gz: 803bb9b519cc14baa104b41689c56dbe168fae17a1ec540a07dedcb8acc1200418f231446fe6ccd611f84d1c0607ffa335a312bed905512b5a95e12592bb6805
+  data.tar.gz: 51d06bdd84b8272d5af59bd9bbc4efd407d39a9b57c343a8d96a68e504770a135a951e18defa50b18e95443c319194c33e31287d922d63e7af4520f35345b85a

data/README.md

@@ -68,9 +68,8 @@ Thanks to [shakacode](https://github.com/shakacode/react_on_rails)
 and [ElMassimo](https://github.com/ElMassimo) for inspiring and helping me with their gems.
 
 **STATUS:** This gem is in the early stages of development, but is ready for use.
-It has nearly 100% test coverage and all tests pass. Since 15 May 2025, it has been successfully
-implemented on my first customer's app: an ERP system with fat Svelte components that are crucial for the workflow.
-of this company.
+It has nearly 100% test coverage, with all tests passing. It has been in use since May/June 2025
+on the systems of my two biggest customers.
 
 If you have issues, please open one, and contributors are welcome!
 
@@ -81,6 +80,7 @@ If you have issues, please open one, and contributors are welcome!
   - ruby 3.2.2 and rails 7.1
   - ruby 2.7.5 and rails 6.1
   - vite@6 (v7 not supported, see issues)
+  - turbolinks and hotwired/turbo
 - vite_rails (the installer will install it by option --full or --vite)
 - svelte v5 (see: [how to install svelte on rails/vite](https://dev.to/chmich/setup-inertia-and-svelte-on-rails-7-3glk))
 - turbo (recommended / [how to install turbo on rails](https://github.com/hotwired/turbo-rails?tab=readme-ov-file#installation))
@@ -262,10 +262,8 @@ after any `*.svelte` file within the configured `components_folder` changed.
 
 `ssr: :auto` is the default option, as set on config file and can be overridden on the view helper.
 
-Works with `hotwired/turbo` only
-
 By passing the `ssr: :auto` option to the view helper,
-it checks if the request is an initial request (request header `X-Turbo-Request-ID` is present):
+it checks if the request is an initial request (request header `X-Turbo-Request-ID` is present // configurable by `non_ssr_request_header`):
 
 On Initial-Request, it adds the attribute `data-svelte-on-rails-initialize-action="hydrate"` and
 returns a server side rendered component that will be hydrated on the frontend by the npm package.
@@ -280,6 +278,20 @@ loaded on very first load to the frontend, then the most work is done
 in frontend and the server is relieved, except on initial request.
 You will see no unpleasant «blink» on the page.
 
+**Turbolinks**
+
+If you are working on turbolinks, you can config the header or set something like 
+ 
+```
+document.addEventListener('turbolinks:request-start', (event) => {
+    var xhr = event.data.xhr
+    xhr.setRequestHeader("X-Turbo-Request-ID", "any-content-for-skip-svelte-ssr")
+});
+```
+
+to your javascript file.
+
+
 **Tip: Performance optimisation for dropdowns**
 
 For example, with dropdowns, you will never see the unpleasant «blink» effect because

data/lib/svelte_on_rails/configuration.rb

@@ -83,6 +83,15 @@ module SvelteOnRails
       end
     end
 
+    def non_ssr_request_header
+      rss = @configs['non_ssr_request_header']
+      if rss.present?
+        rss
+      else
+        'X-Turbo-Request-ID'
+      end
+    end
+
     # def dist_folder(app_root = nil)
     #   rails_root(app_root).join('public', 'svelteDist')
     # end

data/lib/svelte_on_rails/view_helpers.rb

@@ -26,7 +26,12 @@ module SvelteOnRails
       unless [true, false, :auto].include?(rss)
         raise "Only true, false or auto are allowed for the argument #ssr"
       end
-      ssr = (rss == :auto && request.headers['X-Turbo-Request-ID'].blank? || rss)
+
+      ssr = if [:auto, 'auto'].include?(rss)
+              request.headers[conf.non_ssr_request_header].blank?
+            else
+              rss
+            end
 
       hydrate = if props.key?(:hydrate)
                   props[:hydrate]

data/templates/config_base/config/svelte_on_rails.yml

@@ -11,6 +11,11 @@ ssr: :auto
 # :auto: render server side if request is initial request (works only with turbo, because it checks for the X-Turbo-Request-ID header)
 # when not server-side rendered the components must be built as custom elements, see node-package @csedl/svelte-on-rails
 
+non_ssr_request_header: 'X-Turbo-Request-ID'
+# when ssr: :auto =>
+# when this header contains any value (not blank), we are skipping server-side rendering
+# when this header is empty we assume initial request and doing server-side rendering
+
 development:
   watch_changes: true
   # Check on every request if any file within the svelte components folder have changed, for recompiling

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: svelte-on-rails
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.1
 platform: ruby
 authors:
 - Christian Sedlmair