compony 0.6.4 → 0.7.0

data/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Mon Nov 10 13:15:57 2025 by
+  Generated on Fri Nov 14 15:08:15 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.3.5).
 </div>

data/lib/compony/component.rb

@@ -49,6 +49,14 @@ module Compony
       @content_blocks = NaturalOrdering.new
       @actions = NaturalOrdering.new
       @skipped_actions = Set.new
+      @path_block = proc do |model = nil, *args_for_path_helper, standalone_name: nil, **kwargs_for_path_helper|
+        kwargs_for_path_helper.merge!(id: model.id) if model
+        next Rails.application.routes.url_helpers.send(
+          "#{Compony.path_helper_name(comp_cst, family_cst, standalone_name&.to_sym)}_path",
+          *args_for_path_helper,
+          **kwargs_for_path_helper
+        )
+      end
 
       init_standalone
       init_labelling
@@ -83,26 +91,26 @@ module Compony
       "#{family_name}_#{comp_name}_#{@index}"
     end
 
-    # Returns the id path from the root_comp.
+    # Returns the id_path from the root_comp.
     # Do not overwrite.
-    def path
+    def id_path
       if root_comp?
         id
       else
-        "#{parent_comp.path}/#{id}"
+        "#{parent_comp.id_path}/#{id}"
       end
     end
 
-    # Returns a hash for the path. Used for params prefixing.
+    # Returns a hash for the id_path. Used for params prefixing.
     # Do not overwrite.
-    def path_hash
-      Digest::SHA1.hexdigest(path)[..4]
+    def id_path_hash
+      Digest::SHA1.hexdigest(id_path)[..4]
     end
 
-    # Given an unprefixed name of a param, adds the path hash
+    # Given an unprefixed name of a param, adds the id_path hash
     # Do not overwrite.
     def param_name(unprefixed_param_name)
-      "#{path_hash}_#{unprefixed_param_name}"
+      "#{id_path_hash}_#{unprefixed_param_name}"
     end
 
     # Instanciate a component with `self` as a parent
@@ -124,6 +132,20 @@ module Compony
     # Returns the component name
     delegate :comp_name, to: :class
 
+    # DSL method
+    # Overrides how the path to this component should be generated.
+    # The block will be given the following args: a model (optional), pos. args for the path helper, the kwarg `standalone_name` and kwargs for the path helper.
+    # The block is expected to return a Rails path. It is not given `controller` or `helpers`, instead use: `Rails.application.routes.url_helpers`.
+    # For an example, refer to the initializer of this class, where the default block is defined.
+    def path(*, **, &block)
+      if block_given?
+        # Assignment via DSL
+        @path_block = block
+      else
+        @path_block.call(*, **)
+      end
+    end
+
     # DSL method
     # Adds or overrides a before_render block.
     # You can use controller.redirect_to to redirect away and halt the before_render/content chain

data/lib/compony/components/with_form.rb

@@ -5,8 +5,7 @@ module Compony
     # It can be called via :get or via `submit_verb` depending on whether its form should be shown or submitted.
     class WithForm < Component
       def initialize(...)
-        # TODO: On the next line, use Compony.path instead? Likely, this was implemented before that method existed.
-        @submit_path_block = ->(controller) { controller.helpers.send("#{Compony.path_helper_name(comp_name, family_name)}_path") }
+        @submit_path_block = proc { Compony.path(comp_name, family_name, @data) }
         @form_cancancan_action = :missing
         super
       end

data/lib/compony.rb

@@ -95,7 +95,7 @@ module Compony
   ##########=====-------
 
   # Generates a Rails path to a component. Examples: `Compony.path(:index, :users)`, `Compony.path(:show, User.first)`
-  # @param comp_name_or_cst [String,Symbol] The component that should be loaded, for instance `ShowForAll`, `'ShowForAll'` or `:show_for_all`
+  # @param comp_name_or_cst_or_class [String,Symbol] The component that should be loaded, for instance `ShowForAll`, `'ShowForAll'` or `:show_for_all`
   #                         or can also pass a component class (such as Components::Users::Show)
   # @param model_or_family_name_or_cst [String,Symbol,ApplicationRecord] Either the family that contains the requested component,
   #                                    or an instance implementing `model_name` from which the family name is auto-generated. Examples:
@@ -104,14 +104,15 @@ module Compony
   # @param args_for_path_helper [Array] Positional arguments passed to the Rails helper
   # @param kwargs_for_path_helper [Hash] Named arguments passed to the Rails helper. If a model is given to `model_or_family_name_or_cst`,
   #                                      the param `id` defaults to the passed model's ID.
-  def self.path(comp_name_or_cst, model_or_family_name_or_cst = nil, *args_for_path_helper, standalone_name: nil, **kwargs_for_path_helper)
+  def self.path(comp_name_or_cst_or_class, model_or_family_name_or_cst = nil, *args_for_path_helper, standalone_name: nil, **kwargs_for_path_helper)
     # Extract model if any, to get the ID
-    kwargs_for_path_helper.merge!(id: model_or_family_name_or_cst.id) if model_or_family_name_or_cst.respond_to?(:model_name)
-    return Rails.application.routes.url_helpers.send(
-      "#{path_helper_name(comp_name_or_cst, model_or_family_name_or_cst, standalone_name&.to_sym)}_path",
-      *args_for_path_helper,
-      **kwargs_for_path_helper
-    )
+    model = model_or_family_name_or_cst.respond_to?(:model_name) ? model_or_family_name_or_cst : nil
+    comp_class = if comp_name_or_cst_or_class.is_a?(Class) && (comp_name_or_cst_or_class <= Compony::Component)
+                   comp_name_or_cst_or_class
+                 else
+                   comp_class_for!(comp_name_or_cst_or_class, model_or_family_name_or_cst)
+                 end
+    return comp_class.new.path(model, *args_for_path_helper, standalone_name:, **kwargs_for_path_helper)
   end
 
   # Given a component and a family/model, this returns the matching component class if any, or nil if the component does not exist.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: compony
 version: !ruby/object:Gem::Version
-  version: 0.6.4
+  version: 0.7.0
 platform: ruby
 authors:
 - Sandro Kalbermatter
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-10 00:00:00.000000000 Z
+date: 2025-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard