fix: make ISC documents addressable like .imp maps

Two parity gaps with the legacy DSL, both fatal to Compiler::Ruby:

- Document#name now derives from the file name (locate() and
  Maps.transliterate address maps that way). Registering under the
  system code made every map whose code differs from its file name
  resolve to a Hash-default empty entry — stages[:main].call crashed.
  3106 of the sweep's 3175 failures were this crash.

- Every alias and stage now carries doc_name. The Ruby/JS compilers
  emit run directives as Maps.transliterate(stage.doc_name, ...);
  without it, aliased-dependency runs (un-ell runs elot, 131 maps)
  compiled to transliterate(nil, s, :main).

Author: ronaldtse

lib/interscript/isc/node_adapter.rb

@@ -26,10 +26,22 @@ def build
         Interscript::Node::Document.new.tap do |doc|
           doc.metadata = build_metadata
           doc.tests = build_tests
-          doc.aliases = build_aliases
-          build_stages.each { |name, stage| doc.stages[name] = stage }
+          # Maps are addressed by their file-derived name (locate() and
+          # Maps.transliterate use it); registering under the system code
+          # made every map whose code differs from its file name resolve
+          # to an auto-created empty entry — stages[:main].call crashed.
+          doc.name = if @isc_doc[:filename]
+            File.basename(@isc_doc[:filename].to_s, ".isc")
+          else
+            @isc_doc[:systemCode]
+          end
+          # The legacy DSL stamps doc_name on every alias and stage; the
+          # Ruby/JS compilers emit run directives and alias lookups as
+          # Maps.transliterate(stage.doc_name, ...) — without it every
+          # aliased-dependency run compiled to transliterate(nil).
+          doc.aliases = build_aliases(doc.name)
+          build_stages(doc.name).each { |name, stage| doc.stages[name] = stage }
           build_dependencies(doc)
-          doc.name = @isc_doc[:systemCode]
         end
       end
 
@@ -53,12 +65,14 @@ def build_tests
         tests
       end
 
-      def build_aliases
+      def build_aliases(doc_name)
         @isc_doc[:aliases].each_with_object({}) do |a, h|
           # The runtime resolves aliases through AliasDef#data (see
           # Interpreter::Stage#build_item); a bare item here hands it a
           # raw Array once Any#data unrolls.
-          h[a[:name].to_sym] = Interscript::Node::AliasDef.new(a[:name].to_sym, convert_item(a[:value]))
+          alias_def = Interscript::Node::AliasDef.new(a[:name].to_sym, convert_item(a[:value]))
+          alias_def.doc_name = doc_name
+          h[a[:name].to_sym] = alias_def
         end
       end
 
@@ -90,9 +104,11 @@ def load_dependency_document(full_name)
         end
       end
 
-      def build_stages
+      def build_stages(doc_name)
         @isc_doc[:stages].each_with_object({}) do |stage, h|
-          h[stage[:name].to_sym] = build_stage(stage)
+          built = build_stage(stage)
+          built.doc_name = doc_name
+          h[stage[:name].to_sym] = built
         end
       end
 

spec/interscript/isc/node_adapter_spec.rb

@@ -358,3 +358,18 @@ def parse_and_adapt(src)
     expect(interp.call("αγκα")).to eq("αnκα")
   end
 end
+
+RSpec.describe "NodeAdapter document name derivation" do
+  it "names the document after the file, not the system code — transliteration addresses maps by file name" do
+    tree = Interscript::Isc::Parser.parse(
+      'system "TOTALLY:diff-Code:frm:File" { stage main { sub { from "a" to "b" } } }'
+    )
+    doc = Interscript::Isc::DocumentBuilder.build(tree, filename: "test-map.isc")
+    node = Interscript::Isc::NodeAdapter.to_interscript_node(doc)
+    # The Ruby compiler registers compiled maps under Document#name and
+    # Maps.transliterate looks them up by the map name (file-derived).
+    # Registering under the system code auto-creates an empty entry via
+    # the Hash default block and crashes on stages[:main].call.
+    expect(node.name).to eq("test-map")
+  end
+end

spec/isc_corpus_spec.rb

@@ -25,4 +25,14 @@
     expect(Interscript.transliterate("bgnpcgn-deu-Latn-Latn-2000", "Tschüß!"))
       .to eq("Tschueß!")
   end
+
+  it "compiles an aliased-dependency run through the Ruby compiler (un-ell runs elot)" do
+    skip "maps checkout not present" unless File.file?(File.expand_path("un-ell-Grek-Latn-1987-ts.isc", MAPS))
+
+    compiled = Interscript::Compiler::Ruby.call("un-ell-Grek-Latn-1987-ts")
+    # The run directive compiles to Maps.transliterate(stage.doc_name, ...);
+    # without doc_name stamped on ISC stages it emitted transliterate(nil)
+    # and crashed on stages[:main].call at runtime.
+    expect(compiled.call("Ένα")).to eq("Éna")
+  end
 end