gamefic 4.2.0 → 4.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 923f92309b7fcac0e2ed6aa4e691e2feea39521f15f19c7b7a560ddb7583b365
-  data.tar.gz: 858516d0d245300605612517d833e858b84b8a40473f6e9bf7d8670c5589cd77
+  metadata.gz: 59bd1690879679cdd45c163968253a1fbc72b31f01cc96dbadcae33ef91b2ff4
+  data.tar.gz: 8cb18e1eb8322c6174fd313636f18937a03ffdc87e5b546e2619ced95fe54521
 SHA512:
-  metadata.gz: d3d3aa37745380138eb41ed6bee89231e96b385a1c5b8fffc42eb90bb23e9fdcb5d9ea0466fe7f5e1b2d9d459609ec002c3f80d6d6ab324658cbdea4fce1aee2
-  data.tar.gz: 16a1c623c7fc6173f306f43ca080b668b72fdef3700469a6b421abcf88df04c405137f1458727754fce9706107502d7bc0f1dd4cf6c91115784e14de38a6af5e
+  metadata.gz: fb9dc7e48fdae91f4ec59c9969353083367c6bd8706e2dde4dd45aeefbe49631d4789b285945ed78ad1f0094282bc54ea276e1448942e64a571bdcdb137dd971
+  data.tar.gz: 0c09e76fa4d56e7b36109cebf438679feb7aaffa61a82b49f12f3c0795df2a976176783d07f8ee796ca3d93f7c382adb5e426752e605deb2daff3ce8b2c418e5

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 4.2.2 - May 18, 2026
+- Freeze output raw data
+- Seeds#construct macro
+
+## 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/props/output.rb

@@ -88,6 +88,7 @@ module Gamefic
 
       def freeze
         raw_data.freeze
+        raw_data.each_value(&:freeze)
         super
       end
 

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/seeds.rb

@@ -29,6 +29,11 @@ module Gamefic
       # This method adds an instance method for the entity and a class method to
       # reference it with a proxy.
       #
+      # @!macro gamefic.construct
+      #   @!method $1
+      #     @return [$2]
+      #   @!method self.$1
+      #     @return [Proxy]
       # @param name [Symbol, String] The method name for the entity
       # @param klass [Class<Gamefic::Entity>]
       # @return [void]

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.2'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: gamefic
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.2.2
 platform: ruby
 authors:
 - Fred Snyder
 bindir: bin
 cert_chain: []
-date: 2025-11-27 00:00:00.000000000 Z
+date: 2026-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -253,7 +253,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Gamefic
 test_files: []