inform-runtime 1.0.4 → 1.2.0

data/lib/story_teller/model_adapter.rb

@@ -0,0 +1,132 @@
+# lib/story_teller/model_adapter.rb
+# encoding: utf-8
+# frozen_string_literal: false
+
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
+#
+# This file is part of StoryTeller.
+#
+# StoryTeller is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# StoryTeller is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
+
+# The StoryTeller module
+module StoryTeller
+  # The ModelAdapter module
+  module ModelAdapter
+    RequiredAdapterKeys = %i[name object_class tag_class link_class module_class].freeze
+    ExcludedObjectModelModuleNames = ['Inform::Context'].freeze
+
+    Registry = Struct.new(:memo).new(nil)
+
+    def current
+      Registry.memo
+    end
+    module_function :current
+
+    def current=(adapter)
+      Registry.memo = adapter
+    end
+    module_function :current=
+
+    def register!(adapter)
+      validate!(adapter)
+      adapt_object_class!(adapter.fetch(:object_class))
+      self.current = adapter.freeze
+    end
+    module_function :register!
+
+    def validate!(adapter)
+      missing = RequiredAdapterKeys.reject { |key| adapter.key?(key) }
+      raise ArgumentError, "Model adapter is missing keys: #{missing.join(', ')}" unless missing.empty?
+
+      %i[object_class tag_class link_class module_class].each do |key|
+        value = adapter.fetch(key)
+        next if value.is_a?(Class)
+
+        raise ArgumentError, "Model adapter #{key} must be a Class"
+      end
+
+      adapter
+    end
+    module_function :validate!
+
+    def adapt_object_class!(klass)
+      object_model_modules.reverse_each do |mod|
+        klass.include(mod) unless klass < mod
+      end
+      klass
+    end
+    module_function :adapt_object_class!
+
+    def object_model_modules
+      return [] unless defined?(Inform::Object)
+
+      ancestors = Inform::Object.ancestors
+      superclass_index = ancestors.index(Inform::Object.superclass)
+      ancestors[1...superclass_index].select { |ancestor| object_model_module?(ancestor) }
+    end
+    module_function :object_model_modules
+
+    def object_model_module?(ancestor)
+      ancestor.is_a?(Module) && !ExcludedObjectModelModuleNames.include?(ancestor.name)
+    end
+    module_function :object_model_module?
+
+    def available?
+      !current.nil?
+    end
+    module_function :available?
+
+    def object_class
+      current&.fetch(:object_class, nil) || (defined?(Inform::Object) ? Inform::Object : nil)
+    end
+    module_function :object_class
+
+    def tag_class
+      current&.fetch(:tag_class, nil) || (defined?(Inform::Tag) ? Inform::Tag : nil)
+    end
+    module_function :tag_class
+
+    def link_class
+      current&.fetch(:link_class, nil) || (defined?(Inform::Link) ? Inform::Link : nil)
+    end
+    module_function :link_class
+
+    def module_class
+      current&.fetch(:module_class, nil) || (defined?(Inform::Module) ? Inform::Module : nil)
+    end
+    module_function :module_class
+
+    def object_class!
+      object_class || raise(NotImplementedError, 'No object model adapter has been registered')
+    end
+    module_function :object_class!
+
+    def tag_class!
+      tag_class || raise(NotImplementedError, 'No tag model adapter has been registered')
+    end
+    module_function :tag_class!
+
+    def link_class!
+      link_class || raise(NotImplementedError, 'No link model adapter has been registered')
+    end
+    module_function :link_class!
+
+    def module_class!
+      module_class || raise(NotImplementedError, 'No module model adapter has been registered')
+    end
+    module_function :module_class!
+  end
+  # module ModelAdapter
+end
+# module StoryTeller

data/lib/{runtime → story_teller}/plurals.rb

@@ -1,39 +1,39 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of the StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# The StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# The StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 require_relative 'inflector'
 
-# The Inform module
-module Inform
+# The StoryTeller module
+module StoryTeller
   # The Plurals module
   module Plurals
     # Returns the plural form of the word in the string.
     def pluralize(word, n = nil)
       return word if n == 1
-      apply_inflections(word, Inform::Inflector.inflections.plurals)
+      apply_inflections(word, StoryTeller::Inflector.inflections.plurals)
     end
 
     # The reverse of +pluralize+, returns the singular form of a word in a
     # string.
     def singularize(word)
-      apply_inflections(word, Inform::Inflector.inflections.singulars)
+      apply_inflections(word, StoryTeller::Inflector.inflections.singulars)
     end
 
     def singular?(s)
@@ -48,7 +48,7 @@ module Inform
     def apply_inflections(word, rules)
       return "" if word.empty?
       result = word.to_s.dup
-      return result if Inform::Inflector.inflections.uncountables.include?(result.downcase[/\b\w+\Z/])
+      return result if StoryTeller::Inflector.inflections.uncountables.include?(result.downcase[/\b\w+\Z/])
       for (rule, replacement) in rules
         break if result.sub!(rule, replacement)
       end
@@ -57,4 +57,4 @@ module Inform
   end
   # module Plurals
 end
-# module Inform
+# module StoryTeller

data/lib/{runtime → story_teller}/prototype.rb

@@ -1,22 +1,23 @@
+# lib/story_teller/prototype.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # The Inform module
 module Inform
@@ -140,20 +141,20 @@ module Inform
       event = context_event
 
       if MethodWriterPattern.match?(m) || (LinkPattern.match?(m) && !args.empty?)
-        if !event.nil? && Inform::Runtime.invocation_properties.include?(property)
+        if !event.nil? && StoryTeller::Engine.invocation_properties.include?(property)
           event.send(method, *args, &block)
         elsif inflib&.library_method?(method)
           inflib.send(method, *args, &block)
         else
           self.prototype(method, *args, &block)
         end
-      elsif !event.nil? && Inform::Runtime.invocation_properties.include?(property)
+      elsif !event.nil? && StoryTeller::Engine.invocation_properties.include?(property)
         result = event.send(method, *args, &block)
         log.debug("Value for event #{event}.#{method} is: #{result || 'nil'}") if defined? DEBUG
         result
       elsif inflib&.library_method?(method)
         inflib.send(method, *args, &block)
-      elsif inflib.respond_to?(method) && Inform::Runtime.invocation_properties.include?(property)
+      elsif inflib.respond_to?(method) && StoryTeller::Engine.invocation_properties.include?(property)
         inflib.send(method, *args, &block)
       elsif inflib&.instance_variable_get(variable) || inflib&.instance_variables&.include?(variable)
         inflib.instance_variable_get(variable)
@@ -176,7 +177,7 @@ module Inform
     #   return false if m =~ /\?$/
     #   mname = m =~ /\=$/ ? m.chop : m
     #   property = mname.intern
-    #   Inform::Runtime.invocation_properties.include? property
+    #   StoryTeller::Engine.invocation_properties.include? property
     # end
 
     def accessor_and_writer(key)
@@ -232,7 +233,7 @@ module Inform
     end
 
     def key_refers_to_link?(key)
-      Inform::Library::DeclaredProperties.memo.key?(key) && LinkPattern.match?(key.to_s)
+      StoryTeller::Library.declarations.properties.key?(key) && LinkPattern.match?(key.to_s)
     end
 
     def _get(key)

data/lib/{runtime → story_teller}/publication.rb

@@ -1,30 +1,30 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of the StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# The StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# The StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 require_relative 'subscription'
 
-# The Inform module
-module Inform
+# The StoryTeller module
+module StoryTeller
   # The Publisher module to implement rudimentary pub-sub functionality
   module Publisher
-    include Inform::Subscribers
+    include StoryTeller::Subscribers
 
     def muted?
       false
@@ -89,4 +89,4 @@ module Inform
   end
   # module Publisher
 end
-# module Inform
+# module StoryTeller

data/lib/{runtime → story_teller}/session.rb

@@ -1,28 +1,26 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'set'
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # The SessionManagementMethods module
 module SessionManagementMethods
-  Registry = Class.new(Hash)
+  class Registry < Hash; end
   SessionsByChannel = Registry.new
 
   def add_promiscuous_states(*states)

data/lib/{runtime → story_teller}/stdlib.rb

@@ -1,22 +1,23 @@
+# lib/story_teller/stdlib.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # The Inform module
 module Inform
@@ -32,7 +33,7 @@ module StdLib
   end
 
   def executable
-    Runtime.main_gem_spec_executable
+    StoryTeller::Engine.executable
   end
 
   def inversion
@@ -75,7 +76,7 @@ module StdLib
   def import_object_yaml(file)
     return unless defined? YAML
     return if file.nil?
-    YAML.safe_load(File.read(file))
+    YAML.safe_load_file(file)
   end
   alias import_object_yml import_object_yaml
 
@@ -162,7 +163,7 @@ module StdLib
   # rubocop: disable Metrics/AbcSize
   # rubocop: disable Metrics/MethodLength
   def invocation_context(action, *args)
-    ctx = Inform.context
+    ctx = StoryTeller.context
     ctx.results = [
       ctx.action = ctx.action_to_be = action,
       ctx.parameters = args.length,
@@ -215,9 +216,10 @@ module StdLib
   # the opportunity to react to the action, like invoke
   # does, above.
   #
-  # This should be used to delegate an action outcome to
-  # another Verb action subroutine.  It should appear as
-  # if the invoked action is part of the original action.
+  # This should be used to cause an action outcome during
+  # the execution of another Verb action subroutine.  It
+  # should appear as if the invoked action is part of the
+  # original action.
   # !rubocop: disable Metrics/AbcSize
   def _invoke(action, *args)
     raise "The action parameter may not be nil" if action.nil?

data/lib/{runtime → story_teller}/subscription.rb

@@ -1,25 +1,25 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of the StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# The StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# The StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
-# The Inform module
-module Inform
+# The StoryTeller module
+module StoryTeller
   # The Subscribers module
   module Subscribers
     REGISTRY = Struct.new(:memo).new(defined?(Java) ? java.util.concurrent.ConcurrentHashMap.new : {})
@@ -41,7 +41,7 @@ module Inform
     end
 
     def explicit_subscribers
-      Inform::Subscribers::REGISTRY.memo[identity] ||= []
+      StoryTeller::Subscribers::REGISTRY.memo[identity] ||= []
     end
   end
 end

data/lib/{runtime → story_teller}/tree.rb

@@ -1,22 +1,22 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of the StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# The StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# The StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # Tree
 
@@ -146,7 +146,7 @@ module Inform
     # rubocop: disable Metrics/PerceivedComplexity
     def child(o = self, prop = :@children)
       if o.instance_variable_defined?(prop)
-        # The idea here is that o may be an Inform::System::Object.
+        # The idea here is that o may be an Inform::Ephemeral::Object.
         children = o.instance_variable_get(prop)
         return nil unless children.respond_to?(:first)
         children.first

data/lib/{runtime → story_teller}/version.rb

@@ -1,24 +1,34 @@
+# lib/story_teller/version.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of the StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# The StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# The StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
+# module StoryTeller
+module StoryTeller
+  # module Engine
+  module Engine
+    VERSION = '1.2.0'.freeze
+  end
+end
+
+# module Inform
 module Inform
-  VERSION = '1.0.4'.freeze
+  VERSION = StoryTeller::Engine::VERSION
   VN_1610 = '1610'.freeze
 end

data/lib/story_teller/world_tree.rb

@@ -0,0 +1,54 @@
+# lib/story_teller/world_tree.rb
+# encoding: utf-8
+# frozen_string_literal: false
+
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
+#
+# This file is part of the StoryTeller.
+#
+# The StoryTeller is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# The StoryTeller is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
+
+require_relative 'tree'
+require_relative 'daemon'
+
+# class Object
+module Inform
+  # class Object
+  class Object
+    include StoryTeller::Builtins
+    include StoryTeller::IO if defined?(StoryTeller::IO)
+    include StoryTeller::Publisher if defined?(StoryTeller::Publisher)
+    include StoryTeller::Daemons if defined?(StoryTeller::Daemons)
+    include Inform::Context if defined?(Inform::Context)
+    include Inform::Events if defined?(Inform::Events)
+    include Inform::Prototypical if defined?(Inform::Prototypical)
+    include Inform::Linkable if defined?(Inform::Linkable)
+    include Inform::Taggable if defined?(Inform::Taggable)
+    include Inform::Modular if defined?(Inform::Modular)
+    include Inform::Genealogical if defined?(Inform::Genealogical)
+  end
+
+  # class Event
+  class Event
+    include StoryTeller::Publisher
+  end
+end
+
+# The ExtendedProperties class
+class ExtendedProperties < Inform::Object
+  def init
+    has :proper
+    super
+  end
+end

data/lib/story_teller.rb

@@ -0,0 +1,26 @@
+# lib/story_teller.rb
+# encoding: utf-8
+# frozen_string_literal: false
+
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
+#
+# This file is part of StoryTeller.
+#
+# The StoryTeller is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# The StoryTeller is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
+
+require_relative 'story_teller/inform/base'
+require_relative 'story_teller/model_adapter'
+require_relative 'story_teller/inform/models'
+require_relative 'story_teller/ephemeral_adapter'
+require_relative 'story_teller/core'