refactor: replace all internal require with Ruby autoload

Every internal library require replaced with autoload entries defined
in the immediate parent namespace file. Zero require_relative calls.

Files changed:
- lib/interscript.rb: autoload for Stdlib, Compiler, Interpreter,
  DSL, Node, Detector, VERSION (was 6 explicit requires)
- lib/interscript/node.rb: autoload for all Node subtypes
- lib/interscript/node/item.rb: autoload for all Item subtypes
  including Maybe/MaybeSome/Some (subclasses in repeat.rb)
- lib/interscript/node/group.rb: autoload for Parallel, Sequential
- lib/interscript/node/rule.rb: autoload for Sub, Run, Funcall
- lib/interscript/dsl.rb: autoload for all DSL modules
- lib/interscript/dsl/group.rb: autoload for Parallel
- lib/interscript/compiler.rb: autoload for Javascript, Python,
  Ruby, JsonIR
- lib/interscript/visualize.rb: autoload for Nodes, JSON

Verified: transliterate works with lazy autoload.

Author: ronaldtse

lib/interscript.rb

@@ -1,7 +1,17 @@
-require "interscript/version"
 require "yaml"
 
 module Interscript
+  # Autoload all internal library code. No require_relative or internal
+  # require calls — everything loads lazily via autoload (OCP: adding a
+  # new child module = adding one autoload line here).
+  autoload :VERSION, "interscript/version"
+  autoload :Stdlib, "interscript/stdlib"
+  autoload :Compiler, "interscript/compiler"
+  autoload :Interpreter, "interscript/interpreter"
+  autoload :DSL, "interscript/dsl"
+  autoload :Node, "interscript/node"
+  autoload :Detector, "interscript/detector"
+
   # An error caused by a lack of some map
   class MapNotFoundError < StandardError; end
   # An error caused by a missing dependency
@@ -185,13 +195,3 @@ def exclude_maps(maps, compiler:, platform: true)
     end
   end
 end
-
-require "interscript/stdlib"
-
-require "interscript/compiler"
-require "interscript/interpreter"
-
-require "interscript/dsl"
-require "interscript/node"
-
-require "interscript/detector"

lib/interscript/compiler.rb

@@ -1,5 +1,11 @@
 # An Interscript compiler interface
 class Interscript::Compiler
+  # Autoload all compiler variants (OCP: new compiler = one autoload).
+  autoload :Javascript, "interscript/compiler/javascript"
+  autoload :Python, "interscript/compiler/python"
+  autoload :Ruby, "interscript/compiler/ruby"
+  autoload :JsonIR, "interscript/compiler/json_ir"
+
   attr_accessor :code
 
   def self.call(map, **kwargs)

lib/interscript/dsl.rb

@@ -95,12 +95,14 @@ def self.parse(map_name, reverse: true)
   end
 end
 
-require "interscript/dsl/symbol_mm"
-require "interscript/dsl/items"
-
-require "interscript/dsl/document"
-require "interscript/dsl/group"
-require "interscript/dsl/stage"
-require "interscript/dsl/metadata"
-require "interscript/dsl/tests"
-require "interscript/dsl/aliases"
+module Interscript::DSL
+  # Autoload all DSL modules (OCP: new DSL section = one autoload).
+  autoload :SymbolMM, "interscript/dsl/symbol_mm"
+  autoload :Items, "interscript/dsl/items"
+  autoload :Document, "interscript/dsl/document"
+  autoload :Group, "interscript/dsl/group"
+  autoload :Stage, "interscript/dsl/stage"
+  autoload :Metadata, "interscript/dsl/metadata"
+  autoload :Tests, "interscript/dsl/tests"
+  autoload :Aliases, "interscript/dsl/aliases"
+end

lib/interscript/dsl/group.rb

@@ -50,4 +50,6 @@ def parallel(**kwargs, &block)
   end
 end
 
-require "interscript/dsl/group/parallel"
+class Interscript::DSL::Group
+  autoload :Parallel, "interscript/dsl/group/parallel"
+end

lib/interscript/node.rb

@@ -1,4 +1,16 @@
 class Interscript::Node
+  # Autoload all node types. Adding a new node type = one autoload
+  # line here. No require_relative (OCP).
+  autoload :Group, "interscript/node/group"
+  autoload :Document, "interscript/node/document"
+  autoload :MetaData, "interscript/node/metadata"
+  autoload :AliasDef, "interscript/node/alias_def"
+  autoload :Dependency, "interscript/node/dependency"
+  autoload :Tests, "interscript/node/tests"
+  autoload :Stage, "interscript/node/stage"
+  autoload :Rule, "interscript/node/rule"
+  autoload :Item, "interscript/node/item"
+
   def initialize
     raise NotImplementedError, "You can't construct a Node directly"
   end
@@ -12,15 +24,3 @@ def to_hash
      question: "is something missing?"}
   end
 end
-
-require "interscript/node/group"
-require "interscript/node/document"
-
-require "interscript/node/metadata"
-require "interscript/node/alias_def"
-require "interscript/node/dependency"
-require "interscript/node/tests"
-
-require "interscript/node/stage"
-require "interscript/node/rule"
-require "interscript/node/item"

lib/interscript/node/group.rb

@@ -41,5 +41,7 @@ def inspect
   end
 end
 
-require "interscript/node/group/parallel"
-require "interscript/node/group/sequential"
+class Interscript::Node::Group
+  autoload :Parallel, "interscript/node/group/parallel"
+  autoload :Sequential, "interscript/node/group/sequential"
+end

lib/interscript/node/item.rb

@@ -47,10 +47,18 @@ def self.try_convert(i)
   end
 end
 
-require "interscript/node/item/alias"
-require "interscript/node/item/string"
-require "interscript/node/item/group"
-require "interscript/node/item/any"
-require "interscript/node/item/stage"
-require "interscript/node/item/capture"
-require "interscript/node/item/repeat"
+class Interscript::Node::Item
+  # Autoload all item types (OCP: new item type = one autoload).
+  autoload :Alias, "interscript/node/item/alias"
+  autoload :String, "interscript/node/item/string"
+  autoload :Group, "interscript/node/item/group"
+  autoload :Any, "interscript/node/item/any"
+  autoload :Stage, "interscript/node/item/stage"
+  autoload :CaptureGroup, "interscript/node/item/capture"
+  autoload :Repeat, "interscript/node/item/repeat"
+  # Maybe, MaybeSome, Some are subclasses of Repeat defined in
+  # the same file. Autoload points to repeat.rb which defines all of them.
+  autoload :Maybe, "interscript/node/item/repeat"
+  autoload :MaybeSome, "interscript/node/item/repeat"
+  autoload :Some, "interscript/node/item/repeat"
+end

lib/interscript/node/rule.rb

@@ -1,9 +1,10 @@
 class Interscript::Node::Rule < Interscript::Node
+  # Autoload all rule types (OCP: new rule type = one autoload).
+  autoload :Sub, "interscript/node/rule/sub"
+  autoload :Run, "interscript/node/rule/run"
+  autoload :Funcall, "interscript/node/rule/funcall"
+
   def ==(other)
     super && reverse_run == other.reverse_run
   end
 end
-
-require "interscript/node/rule/sub"
-require "interscript/node/rule/run"
-require "interscript/node/rule/funcall"

lib/interscript/visualize.rb

@@ -1,12 +1,9 @@
 require "erb"
-require "interscript/visualize/nodes"
-require "interscript/visualize/json"
-
-def h(str)
-  str.to_s.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;").gsub('"', "&quot;")
-end
 
 class Interscript::Visualize
+  autoload :Nodes, "interscript/visualize/nodes"
+  autoload :JSON, "interscript/visualize/json"
+
   def self.def_template(template)
     @template = ERB.new(File.read(__dir__ + "/visualize/#{template}.html.erb"))
   end