svelte-on-rails 5.3.0 → 5.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f91cbdd2375be3978749859e8bb36b16fbba13fa1e9ac494b9b5e731bc06f91
-  data.tar.gz: f0164b5a93bfb62b2abeedbaebc85064253ad6e4500d9d94a0cfda570416e794
+  metadata.gz: 4b172f3a295136f0317cc6fabb713262b1d1ac813894ef7e07f9b48da61f01a0
+  data.tar.gz: 477f5ce8a86e4d0e7bbf508be99486a9763454ee027b43240cb3432cf5250c37
 SHA512:
-  metadata.gz: f490b501d07cfe64636b73e45ba2b42d30cfc2fc33168488635565fee4a1d3def9e31b5097cbba82aa7ebfad92e08b6a6be30afa53385dbb206e616d6a72352e
-  data.tar.gz: 94e88d6876d9d434e504899f47f5d71ba2d3129a3a55a94992ce6a573d9e78ab305e306f7c3c2576c0135b3aeb03c5578fec74175eb2fc18d89151bac059d664
+  metadata.gz: 2f2595ac48833224788450ce49f31d775ffcd552dd628b630caa450045b02a38c725c81fadeaf4833b6eb8134d32b28c7c1b69fd387b639d0c9c655a22549a08
+  data.tar.gz: fd6aecc7d1923717b5e0119b337d221d6cf0e5c1e4a6b95f5a2a58911787b0e5a4587022850ea546a2c9e385e7d19a8fd96856ecbb07f010830bbe0d5319641b

data/README.md

@@ -5,24 +5,26 @@
 
 ---
 
-Combining [DHH's vision](https://rubyonrails.org/2021/12/15/Rails-7-fulfilling-a-vision) 
-with modern front-end requirements:
+**Svelte on Rails: Modern Front-End + Rails Simplicity**
 
-Svelte.
+Guided by our Principles:
 
-Vite.
+- **Minimal JavaScript but Reactive Power**
+- **Beautiful Code, More Joy, Better Results**
+- **Convention over Configuration**
 
-# Why Choose Svelte for Integration?
+`svelte-on-rails` completes [DHH's vision](https://rubyonrails.org/2021/12/15/Rails-7-fulfilling-a-vision) 
+for modern front-end demands.
 
-Svelte delivers the robust frontend experience missing from DHH’s 
-vision while aligning seamlessly with Rails’ full-stack philosophy.
+# Why Integrate Svelte?
+
+Svelte offers the simplest and most elegant approach to building reactive, high-performance front-end components.
 
 - **Seamless Integration**
   - Works flawlessly with Hotwired/Turbo
-  - Complements Hotwired perfectly
+  - Enhances Hotwire’s capabilities
 - **Developer-Friendly**
-  - Easy to learn
-  - Intuitive and powerful
+  - Simple to learn, intuitive, and powerful
   - Lightning-fast performance
 - **Compared to Single Page Apps (SPAs)**
   - Full-stack development delivers maximum value:
@@ -30,20 +32,17 @@ vision while aligning seamlessly with Rails’ full-stack philosophy.
     - Single-source system delivery
   - For the most HTML Hotwired is enough
 - **Compared to Hotwired**
-  - Stimulus is not a tool for writing frontend-apps
-  - Svelte eliminates redundant HTML state logic
+  - Stimulus is not a tool for frontend-apps
+  - Svelte eliminates redundant HTML initial state logic
   - Consolidates component logic into a single file
-  - Offloads rendering of certain HTML components to frontend JavaScript, reducing server load
+  - Offloads rendering to JavaScript by Frontend, Server side Rendering only where necessary, reducing server load
 - **Compared to React/Vue**
-  - Svelte eliminates the virtual DOM, resulting in leaner, more compact packages and faster performance
-    - Watch Rich Harris’ [Rethinking Reactivity](https://svelte.dev/blog/svelte-3-rethinking-reactivity) (3:50–6:40) for a compelling comparison with react
+  - No virtual DOM, resulting in leaner packages and faster performance
+    - See Rich Harris’ [Rethinking Reactivity](https://svelte.dev/blog/svelte-3-rethinking-reactivity) (3:50–6:40) for a compelling comparison
   - Easier to learn
-  - React and Vue having a vaster Community, bigger Ecosystem
-    - But, for integration, like here, this is not importand
-    - Svelte is sufficiently established
-    - Svelte is younger and growing
+  - While React and Vue have larger communities, Svelte’s ecosystem is robust and growing, ideal for Rails integration
 
-Svelte empowers Rails’ full-stack vision with modern, streamlined frontend integration.
+Svelte empowers Rails’ full-stack vision with modern, efficient front-end integration.
 
 # Features
 

data/lib/svelte_on_rails/active_record_extensions.rb

@@ -10,8 +10,25 @@ module SvelteOnRails
     # Returns a hash of attributes, methods, and associations formatted for Svelte components
     def svelte_attributes(*attributes)
       @svelte_attributes ||= begin
+
+                               # separate offset and limit
+
+                               opts = attributes.grep(Hash).first.symbolize_keys
+                               offset = opts[:offset]
+                               limit = opts[:limit]
+                               attr = if offset || limit
+                                        unless self.respond_to?(:each)
+                                          raise 'offset and limit are only supported for record sets that respond to :each'
+                                        end
+                                        _opts = opts.reject { |key, _| [:offset, :limit].include?(key) }
+                                        attributes.select { |item| !item.is_a?(Hash) }.push(_opts)
+                                      else
+                                        attributes
+                                      end
+
                                utils = SvelteOnRails::Lib::Utils
-                               utils.svelte_attributes(self, attributes)
+                               utils.svelte_attributes(self, attr, offset: offset, limit: limit)
+
                              end
     end
 

data/lib/svelte_on_rails/lib/utils.rb

@@ -163,21 +163,9 @@ module SvelteOnRails
         end
       end
 
-      def self.svelte_attributes(record, attributes, labels = {}, call_stack: 0, offset: nil, limit: nil)
+      def self.svelte_attributes(record, attributes, labels: {}, call_stack: 0, offset: nil, limit: nil)
 
-        if record.respond_to?(:each)
-          unless record.is_a?(ActiveRecord::Relation) || record.is_a?(ActiveRecord::Associations::CollectionProxy)
-            raise 'record set must be a Article::ActiveRecord_Associations_CollectionProxy'
-          end
-
-          recs = (limit ? record.limit(limit) : record)
-          recs2 = (offset ? recs.offset(limit) : recs)
-
-          values = recs2.map do |rec|
-            svelte_attributes(rec, attributes, labels, call_stack: call_stack + 1)
-          end
-
-        elsif record.is_a?(Class)
+        if record.is_a?(Class)
 
           # this is the case if a belongs_to association is empty; In that case we pass the class itself and extract only the labels
           raise 'limit and offset are supported only for iterable objects' if limit || offset
@@ -189,6 +177,19 @@ module SvelteOnRails
           end
           values = {}
 
+        elsif record.respond_to?(:each)
+
+          unless record.is_a?(ActiveRecord::Relation) || record.is_a?(ActiveRecord::Associations::CollectionProxy)
+            raise 'record set must be a Article::ActiveRecord_Associations_CollectionProxy'
+          end
+
+          recs = (offset ? record.offset(offset) : record)
+          recs2 = (limit ? recs.limit(limit) : recs)
+
+          values = recs2.map do |rec|
+            svelte_attributes(rec, attributes, labels: labels, call_stack: call_stack + 1)
+          end
+
         else
 
           # we have a single record
@@ -222,20 +223,24 @@ module SvelteOnRails
 
                 # values
 
-                content = record.send(_key)
                 reflect = record.class.reflect_on_association(_key)
                 if reflect
+                  recs = record.send(_key)
+                  content = (recs.present? ? recs : reflect.active_record) # if no record, we extract only the labels
                   if content.respond_to?(:each)
                     values[_key] = svelte_attributes(
-                      content, value, labels,
+                      content,
+                      value,
+                      labels: labels,
                       call_stack: call_stack + 1,
                       offset: offs,
                       limit: lim
                     )
                   else
                     values[_key] = svelte_attributes(
-                      content || reflect.active_record, # if no record, we extract only the labels
-                      value, labels,
+                      content,
+                      value,
+                      labels: labels,
                       call_stack: call_stack + 1,
                       offset: offs,
                       limit: lim
@@ -275,12 +280,12 @@ module SvelteOnRails
         hash_args = attributes.grep(Hash).first.with_indifferent_access # multiple arrays is not possible
 
         offset = if hash_args["#{key}_offset"] && !record.respond_to?("#{key}_offset")
-                 hash_args["#{key}_offset"]
-               end
+                   hash_args["#{key}_offset"]
+                 end
 
         limit = if hash_args["#{key}_limit"] && !record.respond_to?("#{key}_limit")
-                hash_args["#{key}_limit"]
-              end
+                  hash_args["#{key}_limit"]
+                end
 
         [offset, limit]
       end

metadata

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