bridgetown-builder 2.0.0.beta2 → 2.0.0.beta4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5988f5c80e105125c96f5fafb1a62e1b658271aaa1e5ae1f7a18699194213a76
-  data.tar.gz: 5eb9cfed91973c392f207c36e89205b1545c34c817499f8ca98b6b57955c40bd
+  metadata.gz: 7e8d8bc4d32f6a07082eb2d7c6e6820e01739f21a5742a5abb4374f2bf13c020
+  data.tar.gz: 4752ab1d7c675a7e25c168cf5404cdf6a1c0cf50555169d8a6b5bed6cf0d719f
 SHA512:
-  metadata.gz: 9d69e072c3b9ae899ccc16cd2836fc5a90677b4245e62e347a9921cd3a41dbbf009aae2a73dce3295ca6626f16204f64b337bd0d0d6608c97cb4d4ae9f67528d
-  data.tar.gz: 8318fa593a7c4cc620e6a3a1d5b4df5fc21725fb5cffaf25f8e7aba155270be40ba3eead5ec17d8bfa41b7990a8112fba292aae399c06d80b4772fe9071d5aea
+  metadata.gz: 01a130851dae1ed4b8b844cbacf83617d7e9c6bb4894c6afb4ed9ac5fb0213800aef4483c2cb374917d0b955b842994530f9bb13bb4bfaac7a0a55dd7d9ea936
+  data.tar.gz: bbff78bed9825f28cadd3974496b74a64f6033e45c0e948d45196fa3667ed19dadd07fee3ccfd528a0e4d5764d7b86897a5aec19784ff677d8b7d4d195a6476c

data/lib/bridgetown-builder/dsl/generators.rb

@@ -4,6 +4,10 @@ module Bridgetown
   module Builders
     module DSL
       module Generators
+        # Set up a new generator based on the block or method provided which will run alongside
+        # other generators during the build process
+        #
+        # @param method_name [Symbol] use a Builder method rather than a block to run
         def generator(method_name = nil, &block)
           block = method(method_name) if method_name.is_a?(Symbol)
           local_name = name # pull the name method into a local variable

data/lib/bridgetown-builder/dsl/helpers.rb

@@ -5,9 +5,15 @@ module Bridgetown
     module DSL
       module Helpers
         def helpers
-          @helpers # could be nil
+          @helpers # could be nil. gets set once a helper method is actually called
         end
 
+        # Define a helper for use in view templates, alongside built-in helpers, using either a
+        # builder method or a block
+        #
+        # @param helper_name [Symbol] name of the helper
+        # @param method_name [Symbol] name of a Builder method to use, if block isn't provided
+        #   and the method is named different from the helper
         def helper(helper_name, method_name = nil, &block)
           m = Module.new
 

data/lib/bridgetown-builder/dsl/hooks.rb

@@ -4,6 +4,13 @@ module Bridgetown
   module Builders
     module DSL
       module Hooks
+        # Define a hook to run at some point during the build process
+        #
+        # @param owner [Symbol] name of the owner (`:site`, `:resource`, etc.)
+        # @param event [Symbol] name of the event (`:pre_read`, `:post_render`, etc.)
+        # @param method_name [Symbol] name of a Builder method to use, if block isn't provided
+        # @param priority [Integer, Symbol] either `:low`, `:normal`, or `:high`, or an integer.
+        #   Default is normal (20)
         def hook(
           owner,
           event,
@@ -17,9 +24,13 @@ module Bridgetown
           functions << { name:, hook: [owner, event, priority, hook_block] }
         end
 
+        # Define a site post_read hook and add data returned by the block to the site data/signals
         def add_data(data_key)
           hook(:site, :post_read) do
-            site.data[data_key] = yield
+            yield.tap do |value|
+              site.data[data_key] = value
+              site.signals[data_key] = value
+            end
           end
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bridgetown-builder
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta2
+  version: 2.0.0.beta4
 platform: ruby
 authors:
 - Bridgetown Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-18 00:00:00.000000000 Z
+date: 2025-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bridgetown-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta2
+        version: 2.0.0.beta4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta2
+        version: 2.0.0.beta4
 description:
 email: maintainers@bridgetownrb.com
 executables: []