interscript 3.3.0 → 3.5.0

data/lib/interscript/node/rule/use.rb

@@ -0,0 +1,31 @@
+class Interscript::Node::Rule::Use < Interscript::Node::Rule
+  # ISC-WF-1 W1/W2: a `use` directive before expansion. The NodeAdapter
+  # expands use directives at build time (macro expansion, spec §3.2), so
+  # this node only appears on documents built without expansion; it names
+  # the ruleset and, when present, the dependency alias and the per-site
+  # override rows.
+  attr_accessor :ruleset, :map, :overrides
+
+  def initialize(ruleset, map: nil, overrides: [])
+    self.ruleset = ruleset
+    self.map = map
+    self.overrides = overrides
+  end
+
+  def to_hash
+    {class: self.class.to_s,
+     ruleset: ruleset,
+     map: map,
+     overrides: overrides.map(&:to_hash)}
+  end
+
+  def ==(other)
+    super && ruleset == other.ruleset && map == other.map && overrides == other.overrides
+  end
+
+  def inspect
+    out = "use #{[map, ruleset].compact.map { |i| "@#{i}" }.join(".")}"
+    out += " override { #{overrides.map(&:inspect).join(", ")} }" unless overrides.empty?
+    out
+  end
+end

data/lib/interscript/node/rule.rb

@@ -3,6 +3,7 @@ class Interscript::Node::Rule < Interscript::Node
   autoload :Sub, "interscript/node/rule/sub"
   autoload :Run, "interscript/node/rule/run"
   autoload :Funcall, "interscript/node/rule/funcall"
+  autoload :Use, "interscript/node/rule/use"
 
   def ==(other)
     super && reverse_run == other.reverse_run

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.3.0"
+  VERSION = "3.5.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.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: interscript
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.5.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-11-05 00:00:00.000000000 Z
+date: 2026-11-12 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