gamefic 4.2.0 → 4.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 923f92309b7fcac0e2ed6aa4e691e2feea39521f15f19c7b7a560ddb7583b365
-  data.tar.gz: 858516d0d245300605612517d833e858b84b8a40473f6e9bf7d8670c5589cd77
+  metadata.gz: 9800fd3de4b72b22f083edb20b4c9b74b58f306ce70266a1a9c2aa6b40b02d1e
+  data.tar.gz: 0ba0352e45dd1609d2070e915d6fcf3e41175fd7e52dafcdb4ed5151967241d9
 SHA512:
-  metadata.gz: d3d3aa37745380138eb41ed6bee89231e96b385a1c5b8fffc42eb90bb23e9fdcb5d9ea0466fe7f5e1b2d9d459609ec002c3f80d6d6ab324658cbdea4fce1aee2
-  data.tar.gz: 16a1c623c7fc6173f306f43ca080b668b72fdef3700469a6b421abcf88df04c405137f1458727754fce9706107502d7bc0f1dd4cf6c91115784e14de38a6af5e
+  metadata.gz: 1350f7c939581714ba21108e8376faf4091905a5a85e15ec2d7b4fdc0e44de9c6057698117b04abcf763cf4b3cc74d807383c609c23814973cca58b0a318a59e
+  data.tar.gz: fc2464dbfc163a53742af0e286623a08f67c70472acabd8bfb0176aadfd18431b3f7c41a340264cbf79c9b493b8cda0fcf4b13b91be086cf9442ec9b971f3a4e

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 4.2.1 - February 1, 2026
+- Correct Scenes#introduction documentation
+- Fix parsing of piped verbs
+- Binding documentation
+
 ## 4.2.0 - November 27, 2025
 - Syntaxes support variable (piped) words
 - Props::MultipleChoice#index_of

data/lib/gamefic/binding.rb

@@ -1,22 +1,45 @@
 # frozen_string_literal: true
 
 module Gamefic
+  # A lightweight wrapper around a `Proc` that executes it in the context of a
+  # specific narrative.
+  #
+  # Gamefic stores most author-written blocks (responses, callbacks, etc.) as
+  # plain Ruby procs. Those blocks are intended to run within the context of
+  # their parent narrative so they can call the narrative's methods.
+  # Gamefic::Binding pairs the proc with its narrative and provides a safe way
+  # to execute it.
+  #
   class Binding
     class << self
+      # A map of objects and the stack of narratives in which they're currently
+      # involved.
+      #
       def registry
         @registry ||= {}
       end
 
+      # Push a narrative to the top of an object's stack.
+      #
+      # @param object [Object]
+      # @param narrative [Narrative]
       def push(object, narrative)
         registry[object] ||= []
         registry[object].push narrative
       end
 
+      # Remove a narrative from the top of an object's stack.
+      #
+      # @param object [Object]
       def pop(object)
         registry[object].pop
         registry.delete(object) if registry[object].empty?
       end
 
+      # Fetch the narrative at the top of an object's stack.
+      #
+      # @param object [Object]
+      # @return [Narrative, nil]
       def for(object)
         registry.fetch(object, []).last
       end
@@ -35,6 +58,9 @@ module Gamefic
       @code = code
     end
 
+    # Execute the binding's code within the context of the narrative.
+    #
+    # @return [void]
     def call(*args)
       args.each { |arg| Binding.push arg, @narrative }
       @narrative.instance_exec(*args, &@code)

data/lib/gamefic/scriptable/scenes.rb

@@ -52,15 +52,12 @@ module Gamefic
       end
 
       # Add a block to be executed when a player is added to the game.
-      # Each Plot should only have one introduction.
       #
       # @example Welcome the player to the game
       #   introduction do |actor|
       #     actor.tell "Welcome to the game!"
       #   end
       #
-      # @raise [ArgumentError] if an introduction already exists
-      #
       # @yieldparam [Gamefic::Actor]
       # @yieldparam [Props::Default]
       # @yieldreceiver [Object<self>]

data/lib/gamefic/scriptable/syntaxes.rb

@@ -20,7 +20,7 @@ module Gamefic
       def interpret(command, translation)
         parts = Syntax.split(command)
         additions = if parts.first.include?('|')
-                      parts.first.split('|').map { |verb| Syntax.new("#{verb} #{verb[1..].join(' ')}", translation) }
+                      parts.first.split('|').map { |verb| Syntax.new("#{verb} #{parts[1..].join(' ')}", translation) }
                     else
                       [Syntax.new(command, translation)]
                     end

data/lib/gamefic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gamefic
-  VERSION = '4.2.0'
+  VERSION = '4.2.1'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: gamefic
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.2.1
 platform: ruby
 authors:
 - Fred Snyder
 bindir: bin
 cert_chain: []
-date: 2025-11-27 00:00:00.000000000 Z
+date: 2026-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64