inform-runtime 1.2.2 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c1f6b9a2d86d9855a752009619386dd1e8af63c40e2c0cf9dfba94f38b1ac3c
-  data.tar.gz: b0558bb28bf5348f55b42b0b9a038ba23a77a75ee6c939e5deb843820f616022
+  metadata.gz: 1a9737a28a03ce80dd3698d1fc2824b22cb3090d4f0db6c3b52c84134e17a04c
+  data.tar.gz: 30ea465986dd84a628280ffa63c83228e04689db657d26c1bf449a15a779165a
 SHA512:
-  metadata.gz: 73ad7ed36d79a1a512f9c69c9c1b0069a04718e72c7547869326559bfe3d56f3fea32c383e57191e6ef1c48048195aed4380bc1014d79be13d3a6514c52eebeb
-  data.tar.gz: ebb8265637ff63fe25ea54b9f0dbcdd81a6c9aab2e1b9a900b02b113fe350011973083af788b68c3950a09c2506a514ed59b74daaa09037bfa582bbafed4d7d2
+  metadata.gz: f0f82b48842ed1cb74515abf3e26d2aeadc1c29004177a556e819ff814c3ce7ee63cf8b4225f5a53a3bfa8102c6bfa2ad0a21ad4b2654518269535c9fc3eca0f
+  data.tar.gz: e6122d69fc1a5fbbe2640709f567889a7d70d303740796883bec8ffb3001abd243b91597c02f12a7d31e9aac61de7e08b288cd648c9f784140e935279a2fb085

data/README.md

@@ -1,16 +1,14 @@
-# StoryTeller
+# StoryTeller Engine
 
 [![License](https://img.shields.io/badge/license-GPLv3-blue.svg?style=flat)](license-gpl)
 
-
-
-**StoryTeller** is a runtime layer for use by software programs used to
+**StoryTeller Engine** is a runtime layer for use by software programs used to
 play interactive-fiction games which are built for the [Inform 6 Ruby Port].
 
-StoryTeller is intended to simply provide the barest minimum facilities
-required by the Inform 6 Library Ruby Port software to function in the
-context of a game play specified by a game directory or file. It does not
-attempt to replicate a byte code interpreter runtime like frotz.
+The StoryTeller Engine is intended to simply provide the barest minimum
+facilities required by the Inform 6 Library Ruby Port software to function
+in the context of a game play specified by a game directory or file. It
+does not attempt to replicate a byte code interpreter runtime like frotz.
 
 
 ## Install mise-en-place
@@ -97,81 +95,75 @@ bundle exec rake test
 Here is a bird's-eye view of the project layout.
 
 ```sh
-# date && tree -A -I "game|logs|vendor|tmp|Gemfile.lock"
-Sat Dec 13 22:05:24 CST 2025
+# $ date && tree -A -I "coverage|game|logs|vendor|tmp|Gemfile.lock"
+Sun May 10 09:36:13 CDT 2026
 .
-├── config
-│   └── database.yml
 ├── CONTRIBUTING.md
-├── exe
-│   └── inform.rb
 ├── Gemfile
+├── inform-runtime-1.2.3.gem
 ├── inform-runtime.gemspec
 ├── lib
-│   ├── runtime
+│   ├── story_teller
 │   │   ├── articles.rb
 │   │   ├── builtins.rb
 │   │   ├── color.rb
 │   │   ├── command.rb
-│   │   ├── config.rb
 │   │   ├── context.rb
 │   │   ├── daemon.rb
-│   │   ├── database.rb
+│   │   ├── engine.rb
 │   │   ├── events.rb
 │   │   ├── experimental
-│   │   │   └── handler_dsl.rb
-│   │   ├── game_loader.rb
-│   │   ├── game.rb
+│   │   │   ├── handler_dsl.rb
+│   │   │   └── reverse_engineer_class.rb
 │   │   ├── grammar_parser.rb
 │   │   ├── helpers.rb
 │   │   ├── history.rb
 │   │   ├── inflector.rb
+│   │   ├── inform
+│   │   │   ├── ephemeral
+│   │   │   │   ├── link.rb
+│   │   │   │   ├── module.rb
+│   │   │   │   ├── object.rb
+│   │   │   │   └── tag.rb
+│   │   │   └── models.rb
 │   │   ├── io.rb
 │   │   ├── kernel.rb
-│   │   ├── library_loader.rb
+│   │   ├── library
+│   │   │   ├── bootstrap.rb
+│   │   │   ├── declarations.rb
+│   │   │   ├── directives.rb
+│   │   │   ├── loader.rb
+│   │   │   └── location.rb
 │   │   ├── library.rb
-│   │   ├── link.rb
 │   │   ├── logging.rb
 │   │   ├── mixins.rb
-│   │   ├── module.rb
-│   │   ├── object.rb
-│   │   ├── options.rb
-│   │   ├── persistence.rb
 │   │   ├── plurals.rb
+│   │   ├── privileges.rb
 │   │   ├── prototype.rb
 │   │   ├── publication.rb
-│   │   ├── runtime.rb
 │   │   ├── session.rb
-│   │   ├── snapshots.rb
 │   │   ├── stdlib.rb
 │   │   ├── subscription.rb
-│   │   ├── tag.rb
 │   │   ├── tree.rb
 │   │   ├── version.rb
 │   │   └── world_tree.rb
-│   └── runtime.rb
+│   └── story_teller.rb
 ├── LICENSE
 ├── Rakefile
 ├── README.md
 ├── roller2.jpg
-├── scripts
-│   ├── backup.rb
-│   ├── clone.rb
-│   ├── delete.rb
-│   ├── init.rb
-│   ├── rebuild.rb
-│   └── restore.rb
 └── spec
-    ├── game_spec.rb
+    ├── engine_spec.rb
+    ├── inform_ephemeral_spec.rb
     ├── inform_spec.rb
-    ├── inform_system_spec.rb
-    ├── object_spec.rb
     ├── parser_spec.rb
+    ├── prototype_spec.rb
     ├── spec_helper.rb
+    ├── stdlib_spec.rb
     ├── verblib_spec.rb
     └── verify_gem_spec.rb
 
-7 directories, 63 files
+8 directories, 57 files
 ```
 
 Thanks!

data/lib/story_teller/articles.rb

@@ -1,7 +1,8 @@
+# lib/story_teller/articles.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #

data/lib/story_teller/builtins.rb

@@ -2,7 +2,7 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #
@@ -165,25 +165,78 @@ module Builtins
 
   def objectloop(*_args, &block)
     if self.is_a?(InformLibrary)
-      object_class = StoryTeller::ModelAdapter.object_class
-      object_class&.all&.each { |o| block.call(o) }
+      inform_object_collection.each { |object| block.call(object) }
     elsif self.respond_to?(:descendants)
-      self.descendants.each { |o| block.call(o) }
+      self.descendants.each { |object| block.call(object) }
     end
   end
 
   def getobject(id)
-    object_class = StoryTeller::ModelAdapter.object_class!
-    o = object_class[id]
-    o.refresh
+    object = inform_object_fetch(id)
+    object.refresh if object.respond_to?(:refresh)
+    object
   rescue StandardError
     raise NoSuchObject
   end
 
+  # rubocop: disable Metrics/AbcSize
+  # rubocop: disable Metrics/CyclomaticComplexity
+  # rubocop: disable Metrics/MethodLength
   def findobject(*args, &block)
-    object_class = StoryTeller::ModelAdapter.object_class!
-    return object_class.dataset.order(:name, :id).grep(:name, *args).to_a if args.first.is_a?(Regexp)
-    object_class.dataset.grep(&block).to_a
+    object_class = inform_object_class
+
+    if sequel_model?(object_class)
+      return object_class.dataset.order(:name, :id).grep(:name, *args).to_a if args.first.is_a?(Regexp)
+
+      return object_class.dataset.grep(&block).to_a
+    end
+
+    objects = inform_object_collection
+    if args.first.is_a?(Regexp)
+      return objects.select do |object|
+        object_name_matches?(object, args.first)
+      end
+    end
+
+    block.nil? ? objects : objects.select(&block)
+  end
+  # rubocop: enable Metrics/AbcSize
+  # rubocop: enable Metrics/CyclomaticComplexity
+  # rubocop: enable Metrics/MethodLength
+
+  def inform_object_class
+    if defined?(Inform::Object) && sequel_model?(Inform::Object)
+      Inform::Object
+    elsif defined?(Inform::Ephemeral::Object)
+      Inform::Ephemeral::Object
+    end
+  end
+
+  def sequel_model?(object_class)
+    !object_class.nil? && object_class.respond_to?(:dataset)
+  end
+
+  def inform_object_collection
+    object_class = inform_object_class
+    return Array::Empty if object_class.nil?
+    return object_class.all if object_class.respond_to?(:all)
+
+    Array::Empty
+  end
+
+  def inform_object_fetch(id)
+    object_class = inform_object_class
+    raise NoSuchObject if object_class.nil?
+
+    object = object_class[id] if object_class.respond_to?(:[])
+    raise NoSuchObject if object.nil?
+
+    object
+  end
+
+  def object_name_matches?(object, pattern)
+    name = object.name if object.respond_to?(:name)
+    Array(name).any? { |part| part.to_s.match?(pattern) } || name.to_s.match?(pattern)
   end
 
   def deadflag; @deadflag; end

data/lib/story_teller/color.rb

@@ -1,7 +1,8 @@
+# lib/story_teller/color.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #

data/lib/story_teller/command.rb

@@ -1,7 +1,8 @@
+# lib/story_teller/command.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #
@@ -85,6 +86,8 @@ module PublicCommandMethods
 
   def cancelled?
     return true if future.nil?
+    return false unless future.respond_to?(:cancelled?)
+
     future.cancelled?
   end
 

data/lib/story_teller/context.rb

@@ -2,7 +2,7 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #
@@ -34,42 +34,38 @@ end
 module Inform
   # Define Context module
   module Context
-    module_function
-
     @definition = nil
 
-    def definition
-      @definition
-    end
-
-    alias get definition
-
     AttributeFieldReferenceTemplate = '@%<attribute>s'.freeze
+    AttributeSetterMethodTemplate = '%<attribute>s='.freeze
 
-    def get_value(from, attribute)
-      return from.send(attribute) if from.respond_to?(attribute)
-      from.instance_variable_get(format(AttributeFieldReferenceTemplate, attribute: attribute).to_sym)
-    end
+    class << self
+      attr_reader :definition
+      alias get definition
 
-    AttributeSetterMethodTemplate = '%<attribute>s='.freeze
+      def get_value(from, attribute)
+        return from.send(attribute) if from.respond_to?(attribute)
+        from.instance_variable_get(format(AttributeFieldReferenceTemplate, attribute: attribute).to_sym)
+      end
 
-    def setter_method(attribute)
-      format(AttributeSetterMethodTemplate, attribute: attribute).to_sym
-    end
+      def setter_method(attribute)
+        format(AttributeSetterMethodTemplate, attribute: attribute).to_sym
+      end
 
-    def each_attribute(obj)
-      @definition&.members&.each do |attribute|
-        yield(attribute, get_value(obj, attribute))
+      def each_attribute(obj)
+        @definition&.members&.each do |attribute|
+          yield(attribute, get_value(obj, attribute))
+        end
       end
-    end
 
-    def set(definition)
-      @definition = definition
-      @definition&.members&.each do |attribute|
-        StoryTeller::Command.send(:attr_accessor, attribute) unless StoryTeller::Command.respond_to? attribute
-        Inform::Event.send(:attr_accessor, attribute) unless Inform::Event.respond_to? attribute
+      def set(definition)
+        @definition = definition
+        @definition&.members&.each do |attribute|
+          StoryTeller::Command.send(:attr_accessor, attribute) unless StoryTeller::Command.respond_to? attribute
+          Inform::Event.send(:attr_accessor, attribute) unless Inform::Event.respond_to? attribute
+        end
+        @definition
       end
-      @definition
     end
   end
   # module Context

data/lib/story_teller/daemon.rb

@@ -1,8 +1,8 @@
-# src/lib/daemon.rb
+# lib/story_teller/daemon.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #

data/lib/story_teller/engine.rb

@@ -2,7 +2,7 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #
@@ -33,9 +33,7 @@ module StoryTeller
     module Library
       def play
         log.debug "Using engine-managed InformLibrary play method override"
-        inform_library = StoryTeller::Engine.libraries[StoryTeller::Engine]
-        inform_library.play
-        inform_library
+        StoryTeller::Engine.library.tap(&:play)
       end
     end
 
@@ -45,6 +43,7 @@ module StoryTeller
         environment: 'default',
         inform6lib_gem_code_prefix: 'inform',
         language: 'English',
+        persist_player_location: false,
         properties: 'player actor action action_to_be ' \
           'results parameters pattern ' \
           'noun second inp1 inp2 ' \
@@ -61,6 +60,80 @@ module StoryTeller
       @libraries ||= {}
     end
 
+    def persist_player_location?
+      return @persist_player_location unless @persist_player_location.nil?
+
+      default_config.fetch(:persist_player_location, false)
+    end
+
+    def persist_player_location=(value)
+      @persist_player_location = value
+    end
+
+    def player_object
+      @player_object || parser_selfobj
+    end
+
+    def player_object=(object)
+      raise ManagedLibraryError, "player object is nil" if object.nil?
+
+      @player_object = object
+      replace_parser_selfobj(object)
+      libraries.clear
+    end
+
+    def library(selfobj = player_object)
+      return libraries[selfobj] if !selfobj.nil? && libraries.key?(selfobj)
+
+      inflib = InformLibrary.new.tap { |inflib| inflib.selfobj = selfobj }
+      bind_managed_library(inflib)
+    end
+
+    def replace_parser_selfobj(object)
+      return object unless defined?(Inform::Parser)
+
+      Inform::Parser.send(:remove_const, :SelfObj) if Inform::Parser.const_defined?(:SelfObj, false)
+      Inform::Parser.const_set(:SelfObj, object)
+
+      object
+    end
+
+    def bind_managed_library(inform_library)
+      raise ManagedLibraryError, "InformLibrary is nil" if inform_library.nil?
+
+      selfobj = inform_library.selfobj
+      raise ManagedLibraryError, "InformLibrary selfobj is nil" if selfobj.nil?
+
+      libraries[selfobj] = inform_library
+      selfobj.inflib = inform_library if selfobj.respond_to?(:inflib=)
+
+      ensure_player_location(inform_library) if persist_player_location?
+
+      inform_library
+    end
+
+    # rubocop: disable Metrics/CyclomaticComplexity
+    def ensure_player_location(inflib)
+      return unless persist_player_location?
+      return if inflib.nil?
+
+      existing_location = inflib.instance_variable_get(:@location)
+      return unless existing_location.nil?
+
+      player = inflib.selfobj
+      location = player.location if player.respond_to?(:location)
+      location ||= player.spawn_point if player.respond_to?(:spawn_point)
+
+      inflib.instance_variable_set(:@location, location) unless location.nil?
+    end
+    # rubocop: enable Metrics/CyclomaticComplexity
+
+    def parser_selfobj
+      return nil unless defined?(Inform::Parser::SelfObj)
+
+      Inform::Parser::SelfObj
+    end
+
     def main_object=(obj)
       @main_object = obj
     end
@@ -125,22 +198,13 @@ module StoryTeller
 
     def prime_dictionary
       Inform::Object.select_map(:name).compact.each do |n|
-        StoryTeller::Dictionary.merge(n.split(/[,\s]+/).grep_v(/[^a-z]/i).map(&:downcase).map(&:to_sym))
+        Array(n).join(' ').split(/[,\s]+/).grep_v(/[^a-z]/i).map(&:downcase).map(&:to_sym).each do |word|
+          StoryTeller::Dictionary.merge([word])
+        end
       end
     end
   end
   # module Engine
-
-  # The StoryTeller::Privileges module to implement privilege
-  module Privileges
-    def admin?
-      self.has?(:admin)
-    end
-
-    def builder?
-      admin? || self.has?(:builder)
-    end
-  end
 end
 # module StoryTeller
 

data/lib/story_teller/events.rb

@@ -2,7 +2,7 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of StoryTeller.
 #
@@ -113,7 +113,11 @@ module PublicEventMethods
   end
 
   def <<(event)
-    @successors.add event
+    if @successors.respond_to?(:add)
+      @successors.add(event)
+    else
+      @successors << event
+    end
     event.antecedent = self
   end
 
@@ -141,6 +145,8 @@ module PublicEventMethods
 
   def cancelled?
     return true if future.nil?
+    return false unless future.respond_to?(:cancelled?)
+
     future.cancelled?
   end
 
@@ -752,6 +758,7 @@ module Inform
       Inform::Events.each(event_class) do |event|
         # Do not artificially terminate the source of an interruption.
         next if event == interruption
+        next unless event.future.respond_to?(:cancel)
 
         # Parameterizing Future#cancel with false is supposed to
         # abort the future without interrupting the executing thread.

data/lib/story_teller/experimental/handler_dsl.rb

@@ -2,7 +2,7 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of the StoryTeller.
 #
@@ -21,21 +21,6 @@
 
 # The Inform module
 module Inform
-  # TODO: Testme
-  # class Object
-  #   def after_initialize
-  #     super
-  #     return if new?
-  #     Inform::Behavior.attach(self)
-  #     apply_instance_behavior!
-  #   end
-
-  #   def after_refresh
-  #     super
-  #     apply_instance_behavior!
-  #   end
-  # end
-
   # The Inform::Behavior module
   module Behavior
     class Registry < Hash; end

data/lib/story_teller/experimental/reverse_engineer_class.rb

@@ -2,7 +2,7 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
 #
 # This file is part of StoryTeller.
 #