bridgetown-builder 2.0.0.beta1 → 2.0.0.beta3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be80790b8d2984c7d6fd2eb4e1b8a00ab76aff9130b25a3cd4064dd3bbadfd82
-  data.tar.gz: b96958d6a9b1bd6cdc1a180af7ae53f54069290d7e679a0ec0adcfc0d85835b5
+  metadata.gz: 838d55bbb0f5156418d716123a70ca4332cf730897465522bf2035d5b6ec84b7
+  data.tar.gz: 03b21bc088a0973c209de3bfe345c5f90282ab254b75524d8b66b4f6e1fc837c
 SHA512:
-  metadata.gz: d428ae3dd232c91771cbe169510daaddb332d62421003ca877c8c7d0c6dc176d5ad20640bc6f0d2070f0adf5189a6ce62cbe969e3905c0de2578931fd55d4f9e
-  data.tar.gz: 06ce5dd04af8f8c25277200d6f22d7754ad2f0436dbcf83ef3725fb245f05a21eb826b556976bd99e8e768e741dec90f86ca571b956bb6a5a6b06047b679fd05
+  metadata.gz: b7deb7c43bac84aeef089f883e5dc53837cfcc2d536dcbd41d4f0058f1232c3695ba3755d1ea214c9c574a4b21490d374ebdca83cf82a3aa40c71865ded00c41
+  data.tar.gz: 0620d42e542547589c1f4dd34dae17c0881b9fdd336f9cebfc0a0eaf6fbcc54f6048de04230f6c4e5ba9fa6388cdb3d45c07789f7403e5b045fd63dbe62f7f76

data/bridgetown-builder.gemspec

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "../bridgetown-core/lib/bridgetown-core/version"
+require_relative "../bridgetown-foundation/lib/bridgetown/version"
 
 Gem::Specification.new do |spec|
   spec.name          = "bridgetown-builder"

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

data/lib/bridgetown-builder.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "bridgetown-core"
-require "bridgetown-core/version"
 
 module Bridgetown
   module Builders

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bridgetown-builder
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta1
+  version: 2.0.0.beta3
 platform: ruby
 authors:
 - Bridgetown Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-02 00:00:00.000000000 Z
+date: 2024-11-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.beta1
+        version: 2.0.0.beta3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta1
+        version: 2.0.0.beta3
 description:
 email: maintainers@bridgetownrb.com
 executables: []