interscript 3.2.1 → 3.4.0

data/lib/interscript/node/ruleset.rb

@@ -0,0 +1,6 @@
+class Interscript::Node::Ruleset < Interscript::Node::Stage
+  # ISC-WF-1 W1: a named, reusable block of stage items. Lives on
+  # Node::Document#rulesets, never in #stages — a ruleset never executes
+  # on its own; it only reaches the runtime through `use` expansion
+  # (a macro expansion performed at adapter time).
+end

data/lib/interscript/node.rb

@@ -8,6 +8,8 @@ class Interscript::Node
   autoload :Dependency, "interscript/node/dependency"
   autoload :Tests, "interscript/node/tests"
   autoload :Stage, "interscript/node/stage"
+  autoload :Ruleset, "interscript/node/ruleset"
+  autoload :LanguagesDecl, "interscript/node/languages_decl"
   autoload :Rule, "interscript/node/rule"
   autoload :Item, "interscript/node/item"
 

data/lib/interscript/version.rb

@@ -1,3 +1,3 @@
 module Interscript
-  VERSION = "3.2.1"
+  VERSION = "3.4.0"
 end

data/lib/interscript.rb

@@ -50,9 +50,22 @@ module Interscript
     end
 
     # Transliterates the string.
-    def transliterate(system_code, string, maps = {}, compiler: Interscript::Interpreter)
+    #
+    # ISC-WF-1 W3: `language:` selects one of the map's declared
+    # `languages`, activating the matching `when`-guarded rules. A
+    # selection outside the declaration (or no selection) leaves every
+    # guard inert (spec §5.1).
+    def transliterate(system_code, string, maps = {}, compiler: Interscript::Interpreter, language: nil)
       # The current best implementation is Interpreter
-      load(system_code, maps, compiler: compiler).call(string)
+      compiled = load(system_code, maps, compiler: compiler)
+      if language.nil?
+        compiled.call(string)
+      elsif compiler.equal?(Interscript::Interpreter)
+        compiled.call(string, language: language)
+      else
+        raise ArgumentError,
+          "language selection is only supported by Interscript::Interpreter, not #{compiler}"
+      end
     end
 
     # Gives each possible value of the transliteration.
@@ -82,8 +95,28 @@ module Interscript
       detector.call(source, destination)
     end
 
+    # Locate the interscript-maps registry yaml(s) across installed gems.
+    #
+    # rubygems 4 removed StubSpecification#files, which
+    # Gem.find_latest_files relies on, so the fast path can raise there;
+    # the fallback globs the interscript-maps gems directly (there are
+    # only ever one or two of them, so this stays cheap).
+    def locate_map_gems_yaml
+      found = begin
+        Gem.find_latest_files("interscript-maps.yaml")
+      rescue
+        nil
+      end
+      return found if found.is_a?(Array) && found.any?
+
+      Gem::Specification.latest_specs
+        .select { |spec| spec.name == "interscript-maps" }
+        .flat_map { |spec| Dir.glob(File.join(spec.full_gem_path, "**", "interscript-maps.yaml")) }
+        .uniq
+    end
+
     def map_gems
-      @map_gems ||= Gem.find_latest_files("interscript-maps.yaml").map do |i|
+      @map_gems ||= locate_map_gems_yaml.map do |i|
         [i, YAML.load_file(i)]
       end.to_h
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: interscript
 version: !ruby/object:Gem::Version
-  version: 3.2.1
+  version: 3.4.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-25 00:00:00.000000000 Z
+date: 2026-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: text
   requirement: !ruby/object:Gem::Requirement
@@ -150,6 +150,7 @@ files:
 - lib/interscript/isc/model/document.rb
 - lib/interscript/isc/model/item.rb
 - lib/interscript/isc/model/rule.rb
+- lib/interscript/isc/model/ruleset.rb
 - lib/interscript/isc/model/stage.rb
 - lib/interscript/isc/model/stage_item.rb
 - lib/interscript/isc/model/test.rb
@@ -182,11 +183,14 @@ files:
 - lib/interscript/node/item/repeat.rb
 - lib/interscript/node/item/stage.rb
 - lib/interscript/node/item/string.rb
+- lib/interscript/node/languages_decl.rb
 - lib/interscript/node/metadata.rb
 - lib/interscript/node/rule.rb
 - lib/interscript/node/rule/funcall.rb
 - lib/interscript/node/rule/run.rb
 - lib/interscript/node/rule/sub.rb
+- lib/interscript/node/rule/use.rb
+- lib/interscript/node/ruleset.rb
 - lib/interscript/node/stage.rb
 - lib/interscript/node/tests.rb
 - lib/interscript/stdlib.rb